Ghost MCP Server

To use the Ghost MCP server with MCP clients like Claude Desktop, you must add a configuration entry to your claude_desktop_config.json file. You need to provide your Ghost blog URL, your Admin API key, and the API version. The server is executed via npx using the @fanyangmeng/ghost-mcp package.

{
  "mcpServers": {
      "ghost-mcp": {
        "command": "npx",
        "args": ["-y", "@fanyangmeng/ghost-mcp"],
        "env": {
            "GHOST_API_URL": "https://yourblog.com",
            "GHOST_ADMIN_API_KEY": "your_admin_api_key",
            "GHOST_API_VERSION": "v5.0"
        }
      }
    }
}

The Ghost MCP server requires the following environment variables to authenticate and connect to your Ghost instance:

• GHOST_API_URL: The base URL of your Ghost blog (e.g., https://yourblog.com).
• GHOST_ADMIN_API_KEY: Your Ghost Admin API key for secure access.
• GHOST_API_VERSION: The version of the Ghost API to use (e.g., v5.0).

The Ghost MCP server is designed to run using the StdioServerTransport, which communicates via standard input/output. This is the standard way to connect MCP servers to host applications like Claude Desktop. The server initializes several resource templates and tools to interact with a Ghost CMS instance.

To run the server, ensure it is compiled and executed in an environment where stdio is available. The server logs operational messages to stderr to avoid interfering with the stdout data stream used by the MCP protocol.

# Example of how an MCP host might invoke the server
node /path/to/ghost-mcp/dist/server.js

The ghostApiClient is an instance of GhostAdminAPI initialized using environment-based configuration. To ensure the client connects correctly, the following configuration parameters must be provided (typically via environment variables or a config file):

• GHOST_API_URL: The base URL of your Ghost instance.
• GHOST_ADMIN_API_KEY: A valid Admin API key generated from your Ghost admin dashboard.
• GHOST_API_VERSION: The specific version of the Ghost Admin API to target.

import GhostAdminAPI from '@tryghost/admin-api';
import { GHOST_API_URL, GHOST_ADMIN_API_KEY, GHOST_API_VERSION } from './config';

export const ghostApiClient = new GhostAdminAPI({
    url: GHOST_API_URL,
    key: GHOST_ADMIN_API_KEY,
    version: GHOST_API_VERSION
});

The Ghost MCP server requires specific environment variables to connect to your Ghost instance. If these are missing, the server will fail to start with an error message.

Required variables:

• GHOST_API_URL: The base URL of your Ghost instance (e.g., https://your-blog.com).
• GHOST_ADMIN_API_KEY: Your Ghost Admin API key used for authenticated requests.

Optional variables:

• GHOST_API_VERSION: The version of the Ghost API to use. Defaults to v5.0 if not provided.

export const GHOST_API_URL: string = process.env.GHOST_API_URL as string;
export const GHOST_ADMIN_API_KEY: string = process.env.GHOST_ADMIN_API_KEY as string;
export const GHOST_API_VERSION: string = process.env.GHOST_API_VERSION as string || 'v5.0';

Use the offers_read tool to retrieve details for a specific offer.

Arguments:

• id (string, optional): The unique identifier of the offer.
• code (string, optional): The unique code of the offer.