ghost-mcp

Overview

The Ghost MCP server provides secure access to Ghost CMS through the Model Context Protocol, enabling users to manage their blogs directly via AI interfaces. It implements JWT authentication and offers a rich set of tools for managing posts, users, members, tiers, offers, and newsletters. The server includes advanced search functionality with both fuzzy and exact matching options, and implements robust error handling using custom GhostError exceptions.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• browse_posts

  List posts with optional filters, pagination, and ordering

  Try:Show me all my recent blog postsTry:List posts published in 2023
• read_post

  Retrieve a post by ID or slug

  Try:Get the post with slug 'welcome-post'Try:Show me post with ID 123
• add_post

  Create a new post with title, content, and status

  Try:Create a new post titled 'My Thoughts'Try:Publish a new article about AI
• browse_members

  List members with filters and pagination

  Try:Show all members of my blogTry:List members who joined this month
• read_member

  Retrieve a member by ID or email

  Try:Get member info for email@example.comTry:Show details for member ID 456
• browse_newsletters

  List newsletters

  Try:Show all my newslettersTry:List recent newsletters sent
• browse_offers

  List offers

  Try:Show all promotional offersTry:List active member discounts
• browse_tiers

  List subscription tiers and plans

  Try:Show all membership tiersTry:List current subscription plans
• browse_tags

  List organizational tags for posts

  Try:Show all post tagsTry:List tags in the 'technology' category
• browse_users

  List admin users and staff accounts

  Try:Show all admin usersTry:List staff members with editor role
• browse_webhooks

  List webhooks configured for the site

  Try:Show all webhooksTry:List active payment webhooks
• read_role

  Retrieve a role by ID

  Try:Get details for the 'editor' roleTry:Show permissions for role ID 789

Installation

npm install -g @fanyangmeng/ghost-mcp

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

FAQ

What Ghost CMS versions are supported?

The server is designed to work with Ghost API v5.0, as specified in the environment configuration.

How is authentication handled?

Authentication is managed through Ghost's Admin API using JWT tokens provided via the GHOST_ADMIN_API_KEY environment variable.

Compare ghost-mcp with