Thoth MCP Server

Model Context Protocol (MCP) server for Thoth content creation platform. This server enables AI assistants and tools to create and retrieve content through Thoth's API.

✨ NEW: Claude Code Plugin now available with slash commands and specialized AI agents for streamlined content creation workflows!

Quick Start

# Install via npx
npx @usethoth/mcp-server --api-key YOUR_API_KEY

# Or configure in Claude Desktop (see Configuration below)

Get your API key at app.usethoth.com/settings/api-keys

Table of Contents

• Quick Start
• Features
• Claude Code Plugin
• Installation
• Usage
• MCP Client Configuration
• Available Tools
• Available Resources
• Development
• API Integration
• Examples
• Troubleshooting
• Contributing
• Support
• Changelog

Features

• Create Content: Generate platform-optimized content with AI enhancement
• Retrieve & Manage Posts: Fetch, list, and update post data with pagination
• Multi-Platform Support: Twitter, Instagram, LinkedIn, Facebook, Threads, Blog, Reddit
• Brand Styles: Apply consistent voice, tone, and visual styling with brand presets
• Image Generation: Optionally generate images for your content
• Scheduling: Schedule posts for future publication
• Dual Transport: Supports both stdio (local) and HTTP transports (Smithery/cloud deployment)
• Type-Safe: Built with TypeScript and Zod validation

Claude Code Plugin

NEW! We've created an official Claude Code plugin that makes social media content creation even easier with user-friendly commands and specialized AI agents.

What is it?

The Thoth plugin for Claude Code provides:

• 5 Slash Commands: Quick access to common workflows

  • /create-content - Create multi-platform posts with AI guidance
  • /schedule-post - Schedule posts for optimal engagement times
  • /view-brands - Browse and manage your brand styles
  • /manage-posts - List, filter, and manage all your posts
  • /preview-post - Preview platform-specific content formatting

• 3 Specialized Agents: Expert AI assistants for specific tasks

  • Content Creator - Expert at crafting engaging, platform-optimized content
  • Brand Manager - Ensures brand consistency across all platforms
  • Social Media Optimizer - Maximizes reach and engagement through data-driven strategies

Quick Start with Plugin

# Install the plugin
claude plugin install thoth

# Set your API key
export THOTH_API_KEY="your-api-key-here"

# Start creating content
claude /create-content "Announcing our new feature"

# Or use an agent
claude "Content Creator, help me announce our product launch"

Documentation

Full plugin documentation, installation instructions, and usage examples are available in the claude-code-plugin directory.

See claude-code-plugin/README.md for:

• Detailed installation instructions
• Complete command reference
• Agent usage guides
• Advanc

... View full README on GitHub