Thoth

You can run the Thoth MCP Server to create, retrieve, and manage multi-platform content using Thoth’s API. It supports both local stdio and HTTP transports, along with built-in tools to generatePlatform-specific posts, apply brand styles, and schedule content across major social networks.

How to use

This MCP server enables you to create and retrieve Thoth content from your MCP client. You can operate in stdio mode for local development or in HTTP mode for cloud deployments. Use an MCP client to issue tool calls such as creating posts, listing posts, updating content, and obtaining brand styles. The server handles platform-specific formatting, image generation, hashtags, scheduling, and multi-platform publishing.

How to install

Prerequisites: you need Node.js 18 or newer installed on your system.

Choose an installation method and follow the steps below.

# Via MCP Registry (Recommended)
# Install and run using an API key
npx @usethoth/mcp-server --api-key YOUR_API_KEY

# Global Installation (via npx)
# This is the same as the first approach, executed with npx
npx @usethoth/mcp-server --api-key YOUR_API_KEY

# Via Smithery (Zero-Setup Deployment)
# Visit Smithery and install Thoth MCP Server, then provide your Thoth API key when prompted

# Local Development
# Clone the repository, install dependencies, and build
git clone https://github.com/perminder-klair/thoth-mcp.git
cd thoth-mcp
pnpm install
pnpm build

# Run in stdio mode after building if applicable
pnpm start -- --api-key YOUR_API_KEY

Additional setup notes

You can also run the server in remote HTTP mode to expose an MCP endpoint over the internet. The server listens on port 8081 by default and exposes /mcp for requests and /health for health checks.

Environment variables are available to configure runtime behavior. When running in HTTP mode, you can set PORT to define the listening port and THOTH_BASE_URL to specify the base URL for Thoth API requests.

Troubleshooting

If the server won’t start, verify you have Node.js 18+ installed and that your API key is valid.

If you encounter tool call failures, check your API key permissions and ensure you are targeting valid post IDs and platforms.

For HTTP mode access issues, confirm the port is not in use, verify firewall settings allow connections, and inspect server logs for startup errors.

Notes on configuration and usage

The server supports both stdio and HTTP transports. In stdio mode, run commands directly in your terminal or through an MCP client that uses stdio transport. In HTTP mode, configure and start the server with the remote flag to expose an HTTP endpoint for cloud-based clients.

Examples of common workflows

# Create a multi-platform post via stdio transport
npx @usethoth/mcp-server --api-key YOUR_API_KEY

# Use an MCP client to call the create-post tool with platform targets

# Schedule a post for a future time via HTTP or stdio, depending on your setup

Security considerations

Protect your API keys and avoid exposing them in client configurations. Use environment variables or secret managers in deployment environments and restrict access to the MCP endpoint to trusted clients.

Best practices

• Keep your Thoth API key secure and rotate it periodically.
• Use brand styles to maintain a consistent voice across platforms.
• Leverage scheduling to optimize engagement windows.
• Test new content flows in a development environment before publishing to production.

Tool overview

The MCP server provides a set of tools to manage content creation and retrieval. You can create posts, fetch individual posts, list posts with pagination, update posts, and access brand styles.

Available tools

create-post

Create multi-platform content with AI enhancement across platforms such as twitter, instagram, linkedin, facebook, threads, blog, and reddit.

get-post

Retrieve a specific post by its ID to view platform-specific content and metadata.

get-all-posts

List posts with pagination and optional filtering by status.

update-post

Update an existing post's title, content, or status.

get-brand-styles

List all available brand styles for your account.

get-brand-style

Get detailed information for a specific brand style.