@usethoth/mcp-server
Advanced tools
Model Context Protocol server for Thoth content creation platform
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.
# 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
The server is published in the official MCP Registry as io.github.zeiq-co/thoth-mcp.
Browse and install via the registry web interface, or configure directly in your MCP client (see MCP Client Configuration below).
npx @usethoth/mcp-server --api-key YOUR_API_KEY
git clone https://github.com/perminder-klair/thoth-mcp.git
cd thoth-mcp
pnpm install
pnpm build
You'll need a Thoth API key. Generate one at:
This is the default mode for use with MCP clients like Claude Desktop:
npx @usethoth/mcp-server --api-key YOUR_API_KEY
Or debug with MCP Inspector:
npx @modelcontextprotocol/inspector npx @usethoth/mcp-server --api-key YOUR_API_KEY
With custom base URL:
npx @usethoth/mcp-server \
--api-key YOUR_API_KEY \
--base-url https://app.usethoth.com
Note: Remote HTTP mode is not yet fully implemented. For remote access, consider using an SSH tunnel or MCP proxy with the stdio transport.
# SSH tunnel example (forwards local MCP to remote server)
ssh -R /tmp/mcp.sock:localhost:3000 user@remote-server
Instead of command-line flags, you can use environment variables:
export THOTH_API_KEY=your_api_key
export THOTH_BASE_URL=http://localhost:3000
npx @usethoth/mcp-server
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"thoth": {
"command": "npx",
"args": [
"@usethoth/mcp-server",
"--api-key",
"YOUR_API_KEY",
"--base-url",
"http://localhost:3000"
]
}
}
}
For other MCP clients that support stdio transport, use a similar configuration with appropriate command and args.
The server provides 6 tools for managing Thoth content:
| Tool | Description |
|---|---|
create-post | Create multi-platform content with AI enhancement |
get-post | Retrieve a specific post by ID |
get-all-posts | List posts with pagination and filtering |
update-post | Update existing post title, content, or status |
get-brand-styles | List all available brand styles |
get-brand-style | Get detailed brand style configuration |
Create a new content post with platform-specific variations.
Parameters:
content (required): The original content to be enhancedplatforms (required): Array of target platforms
twitter, instagram, linkedin, facebook, threads, blog, redditlength (optional): Content length - very-short, short, medium, long (default: medium)createImage (optional): Generate an image (default: false)createHashtags (optional): Generate hashtags (default: true)scheduleTime (optional): ISO 8601 datetime to schedule the postpostToSocialNetworks (optional): Immediately post to connected networks (default: false)brandStyleId (optional): Brand style UUID to applyExample:
{
"content": "Just launched our new AI-powered content creation tool!",
"platforms": ["twitter", "linkedin"],
"length": "medium",
"createImage": true,
"createHashtags": true
}
Returns:
Retrieve a post by its ID.
Parameters:
postId (required): UUID of the postExample:
{
"postId": "123e4567-e89b-12d3-a456-426614174000"
}
Returns:
List all posts with pagination and filtering.
Parameters:
page (optional): Page number (default: 1)limit (optional): Posts per page (default: 10)status (optional): Filter by status - draft, scheduled, publishedExample:
{
"page": 1,
"limit": 20,
"status": "published"
}
Returns:
Update an existing post.
Parameters:
postId (required): UUID of the post to updatetitle (optional): New title for the postcontent (optional): New contentstatus (optional): New status - draft, scheduled, publishedExample:
{
"postId": "123e4567-e89b-12d3-a456-426614174000",
"title": "Updated Title",
"status": "published"
}
Returns:
List all available brand styles for your account.
Parameters: None
Returns:
Get details for a specific brand style.
Parameters:
brandStyleId (required): UUID of the brand styleExample:
{
"brandStyleId": "123e4567-e89b-12d3-a456-426614174000"
}
Returns:
Access post data as an MCP resource.
Example URI:
post://123e4567-e89b-12d3-a456-426614174000
Get platform-specific preview content.
Example URI:
preview://123e4567-e89b-12d3-a456-426614174000/twitter
pnpm build
pnpm start -- --api-key YOUR_API_KEY
pnpm typecheck
pnpm dev
The MCP server connects to Thoth's REST API endpoints:
POST /api/v1/posts - Create new postsGET /api/v1/posts/{postId} - Retrieve single postGET /api/v1/posts - List posts with paginationPUT /api/v1/posts/{postId} - Update existing postGET /api/v1/brand-styles - List brand stylesGET /api/v1/brand-styles/{brandStyleId} - Get brand style detailsAll requests require the X-API-Key header for authentication.
The server provides detailed error messages for common issues:
// Using the create-post tool
{
"content": "Excited to share our latest feature! \ud83d\ude80 AI-powered content optimization for all your social platforms.",
"platforms": ["twitter", "linkedin", "instagram"],
"length": "medium",
"createImage": true,
"createHashtags": true
}
{
"content": "Join us for our product launch next week!",
"platforms": ["twitter", "linkedin"],
"scheduleTime": "2025-10-20T14:00:00Z",
"createImage": true
}
// Using the get-post tool
{
"postId": "123e4567-e89b-12d3-a456-426614174000"
}
// Read post resource
{
"uri": "post://123e4567-e89b-12d3-a456-426614174000"
}
// Read platform-specific preview
{
"uri": "preview://123e4567-e89b-12d3-a456-426614174000/twitter"
}
Contributions are welcome! Please follow these steps:
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)Please ensure your code:
pnpm typecheck)console.error() for logging (not console.log() - it breaks stdio mode)See PUBLISHING.md for detailed instructions on building and publishing updates.
MIT License - see the LICENSE file for details.
FAQs
Model Context Protocol server for Thoth content creation platform
The npm package @usethoth/mcp-server receives a total of 36 weekly downloads. As such, @usethoth/mcp-server popularity was classified as not popular.
We found that @usethoth/mcp-server demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Open source maintainers are under more pressure than ever. We're raising our open source program from the Team plan to the Business plan, free.
Security News
The supply chain control that delays freshly published gems now covers lockfile generation and gem vendoring in Ruby projects.
Security News
During a UK cyber test, a Mythos 5 agent used sockpuppets, social engineering, and prompt injection to try to get a maintainer to merge malware.