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

Click the Sync Members button in your ToastMCP dashboard to import members from Ghost. This process:

• 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

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]?"

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 Server-Sent Events (SSE) transport.

Tools Reference

ToastMCP exposes three MCP tools for querying Ghost content:

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"
  }
}

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
• ✅ SOC 2 Type II (in progress)
• ✅ 99.9% uptime SLA