io.github.zeiq-co/thoth-mcp

Install

Config snippet generator goes here (5 client tabs)

README

# Thoth MCP Server

[![npm version](https://badge.fury.io/js/@usethoth%2Fmcp-server.svg)](https://www.npmjs.com/package/@usethoth/mcp-server)
[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.zeiq--co%2Fthoth--mcp-blue)](https://registry.modelcontextprotocol.io/servers/io.github.zeiq-co/thoth-mcp)
[![Smithery](https://img.shields.io/badge/Smithery-Deploy-green)](https://smithery.ai/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![smithery badge](https://smithery.ai/badge/@perminder-klair/thoth-mcp)](https://smithery.ai/server/@perminder-klair/thoth-mcp)

Model Context Protocol (MCP) server for [Thoth](https://usethoth.com) content creation platform. This server enables AI assistants and tools to create and retrieve content through Thoth's API.

**✨ NEW:** [Claude Code Plugin](#claude-code-plugin) now available with slash commands and specialized AI agents for streamlined content creation workflows!

## Quick Start

```bash
# 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](https://app.usethoth.com/settings/api-keys)

## Table of Contents

- [Quick Start](#quick-start)
- [Features](#features)
- [Claude Code Plugin](#claude-code-plugin)
- [Installation](#installation)
- [Usage](#usage)
- [MCP Client Configuration](#mcp-client-configuration)
- [Available Tools](#available-tools)
- [Available Resources](#available-resources)
- [Development](#development)
- [API Integration](#api-integration)
- [Examples](#examples)
- [Troubleshooting](#troubleshooting)
- [Contributing](#contributing)
- [Support](#support)
- [Changelog](#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

```bash
# 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](./claude-code-plugin) directory.

See [claude-code-plugin/README.md](./claude-code-plugin/README.md) for:

- Detailed installation instructions
- Complete command reference
- Agent usage guides
- Advanced workflows and examples
- Troubleshooting tips

## Installation

### Via MCP Registry (Recommended)

The server is published in the [official MCP Registry](https://registry.modelcontextprotocol.io/) 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](#mcp-client-configuration) below).

### Via Smithery (Zero-Setup Deployment)

The easiest way to get started is through [Smithery](https://smithery.ai/), which provides:

- **One-click installation** - No local dependencies or configuration needed
- **Automatic updates** - Always get the latest version
- **Secure hosting** - Your API keys are safely managed
- **Interactive playground** - Test tools before using them

Install from Smithery:

1. Visit the [Thoth MCP Server on Smithery](https://smithery.ai/server/@perminder-klair/thoth-mcp)
2. Click "Install"
3. Enter your Thoth API key when prompted
4. Start using immediately in Claud