Welcome to ToastMCP

What is ToastMCP?

ToastMCP is a Model Context Protocol (MCP) server platform specifically designed for Ghost CMS blogs. It creates a bridge between your Ghost content and AI assistants like Claude, allowing your members to query your content naturally through conversation.

Key Benefits

• New Revenue Stream — Offer AI access as a premium feature and charge extra for it
• Paywall Protection — Your Ghost membership tiers are automatically enforced
• Zero Configuration — Members just copy-paste a URL into their AI assistant
• 5-Minute Setup — Connect your Ghost blog and start syncing members immediately

Choose Your Path

Select the guide that matches your role:

How It Works

ToastMCP connects your Ghost blog to AI assistants through the Model Context Protocol:

Ghost API Setup

To connect ToastMCP to your Ghost blog, you'll need two API keys from your Ghost admin panel.

Getting Your Admin API Key

Member Management

Once connected, ToastMCP automatically syncs your Ghost members and generates unique API keys for each.

Syncing Members

ToastMCP keeps your Ghost members in sync with flexible options:

• Automatic sync: Members are automatically synced every hour
• Manual sync: Click "Sync Members" for immediate updates
• Imports all existing Ghost members
• Preserves membership tier information (Free, Paid, Premium)
• Generates unique API keys for each member
• Sends welcome emails with MCP connection instructions

Managing Access

AI Draft Writing

Blog owners can use AI assistants to write posts and save them directly to Ghost as drafts.

Getting Your Owner API Key

To use AI draft writing, you need your special Owner API Key which has write permissions:

Using the write_draft Tool

Once connected with your Owner API Key, you can ask your AI assistant to create drafts:

• "Write a blog post about [topic]" — Creates a draft with AI-generated content
• "Write a tutorial on [subject] with tags 'tutorial, beginner'" — Includes specific tags
• "Create a draft post titled [title] about [topic]" — Sets a specific title

What Happens After Writing

• The post is saved as a draft in your Ghost admin — never published automatically
• You'll see a confirmation with the draft URL and title
• Go to Ghost Admin → Posts → Drafts to find your new post
• Review, edit, and publish when you're ready

Multiple Blogs

ToastMCP allows you to connect and manage multiple Ghost blogs from a single account.

Blog Limits

There is no limit on the number of Ghost blogs you can connect to ToastMCP. Your plan limits apply to the total number of members across all blogs, not the number of blogs themselves.

Managing Multiple Blogs

Access the blog selector from your dashboard to switch between connected blogs. Each blog has its own:

• Member list and API keys
• Sync settings (automatic or manual)
• MCP endpoint URL
• Usage analytics

Member Guide

This section is for Ghost blog members who want to connect their AI assistant to access blog content.

What You'll Need

• Your MCP URL — Check your email from the blog owner
• Claude Desktop — Download from claude.ai/download

Understanding Your MCP URL

Your connection URL looks like this:

Claude Desktop Setup

Connect Claude Desktop to your Ghost blog in under 5 minutes.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ghost-blog": {
      "type": "url",
      "url": "https://app.toastmcp.com/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ghost-blog": {
      "type": "url",
      "url": "https://app.toastmcp.com/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ghost-blog": {
      "type": "url",
      "url": "https://app.toastmcp.com/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Testing Your Connection

Once connected, try asking Claude:

• "List the 5 most recent posts"
• "Search for posts about [topic]"
• "What did the author write about [subject]?"

ChatGPT Setup

Connect ChatGPT to your Ghost blog using MCP connectors. This requires ChatGPT Pro, Team, or Enterprise.

Testing Your ChatGPT Connection

Once connected, try asking ChatGPT:

• "What are the latest posts on my blog?"
• "Search for articles about [topic]"
• "Summarize the post about [subject]"

Other MCP Clients

ToastMCP works with any MCP-compatible AI assistant. For clients not covered in this documentation (such as Cursor, Windsurf, Continue, or others), please refer to your MCP client's official documentation for configuration instructions.

Most MCP clients require the same basic information:

• MCP Server URL: Your ToastMCP endpoint from the welcome email
• Authentication: None required (API key is embedded in the URL)
• Transport: HTTPS (Streamable HTTP)

If you need assistance setting up a specific MCP client, please contact us at help@toastmcp.com.

MCP Server Reference

Technical documentation for developers integrating with the ToastMCP server.

Endpoint

Authentication

All requests require an API key passed as a query parameter:

?apiKey=mcp_abc123def456...

Protocol

ToastMCP implements the Model Context Protocol (MCP) specification using stateless HTTPS transport (Streamable HTTP).

Tools Reference

ToastMCP exposes MCP tools for querying Ghost content and creating drafts:

get_posts

Retrieve a list of blog posts with filtering options.

{
  "tool": "get_posts",
  "arguments": {
    "limit": 10,
    "filter": "tag:tutorial"
  }
}

search_posts

Full-text search across accessible blog posts.

{
  "tool": "search_posts",
  "arguments": {
    "query": "machine learning tutorial",
    "limit": 5
  }
}

get_post_by_slug

Retrieve full post content by URL slug.

{
  "tool": "get_post_by_slug",
  "arguments": {
    "slug": "getting-started-with-ai",
    "format": "markdown"
  }
}

write_draft

Create a new draft post in your Ghost blog. Owner API Key with write permission required.

{
  "tool": "write_draft",
  "arguments": {
    "title": "Getting Started with AI Writing",
    "content": "<p>This is my first AI-written draft...</p>",
    "tags": "ai, tutorial, getting-started",
    "excerpt": "Learn how to use AI to write blog posts"
  }
}

{
  "draft": {
    "id": "64a1b2c3d4e5f6g7h8i9j0",
    "uuid": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
    "title": "Getting Started with AI Writing",
    "slug": "getting-started-with-ai-writing",
    "status": "draft",
    "url": "https://yourblog.com/getting-started-with-ai-writing/",
    "created_at": "2025-01-06T12:00:00.000Z"
  },
  "message": "Draft created successfully. You can find it in your Ghost admin dashboard."
}

Errors & Rate Limits

ToastMCP uses standard HTTP status codes to indicate success or failure.

Troubleshooting

Frequently Asked Questions

For Blog Owners

For Members

Glossary

Security

ToastMCP is built with security as a core principle.

Data Protection

• Unique API Keys — Each member gets a unique, revocable key
• Server-Side Validation — All access checks happen on our servers
• No Content Storage — We don't cache or store your Ghost content
• HTTPS Only — All connections are encrypted with TLS 1.3

Infrastructure

• Google Cloud Run — Auto-scaling, serverless containers
• Firebase Auth — Enterprise-grade authentication
• Cloud Firestore — Encrypted database with automatic backups

Compliance

• ✅ GDPR compliant
• ✅ 99.9% uptime SLA