Ghost MCP Server

A Model Context Protocol (MCP) server for interacting with Ghost CMS through LLM interfaces like Claude. Allow you to control your Ghost blog by simply asking Claude etc.

Overview

Created by MFYDev

The Ghost MCP Server is a Model Context Protocol (MCP) server designed to facilitate interaction with the Ghost CMS through large language model (LLM) interfaces such as Claude. This server provides secure and comprehensive access to your Ghost blog, leveraging JWT authentication and a rich set of MCP tools for managing posts, users, members, tiers, offers, and newsletters.

For Product Designers, Project Managers, and Design Leaders, this tool streamlines content management workflows by enabling natural language commands to control various aspects of a Ghost blog. This integration can enhance productivity and simplify the management of digital content.

Key Features

• Secure JWT Authentication for Ghost Admin API requests
• Comprehensive entity access including posts, users, members, tiers, offers, and newsletters
• Advanced search functionality with both fuzzy and exact matching options
• Detailed, human-readable output for Ghost entities
• Robust error handling using custom `GhostError` exceptions
• Integrated logging support via MCP context for enhanced troubleshooting

Capabilities

• List, search, read, create, update, and delete blog posts
• Manage tags including browsing, reading, creating, updating, and deleting
• Handle user roles and invitations, list users, read user details, and delete users
• Manage members by listing, reading, creating, and updating member information
• Oversee membership tiers by listing, reading, creating, and updating tiers
• Administer promotional offers by listing, reading, creating, and updating offers
• Control newsletters by listing, reading, creating, and updating newsletters
• Manage webhooks by creating, updating, and deleting them

Available Actions

The ghost tool supports all the same actions as before, but now through a unified interface:

Posts Actions

• list_posts: List blog posts with pagination
• search_posts_by_title: Search for posts by title
• read_post: Retrieve full content of a specific post
• create_post: Create a new post
• update_post: Update a specific post
• delete_post: Delete a specific post
• batchly_update_posts: Update multiple posts in a single request

Tags Actions

• browse_tags: List all tags
• read_tag: Retrieve specific tag information
• create_tag: Create a new tag
• update_tag: Update an existing tag
• delete_tag: Delete a specific tag

Users Actions

• list_roles: List all available roles
• create_invite: Create a new user invitation
• list_users: List all users
• read_user: Get details of a specific user
• delete_user: Delete a specific user

Members Actions

• list_members: List members
• read_member: Retrieve specific member information
• create_member: Create a new member
• update_member: Update an existing member

Tiers Actions

• list_tiers: List all membership tiers
• read_tier: Retrieve specific tier information
• create_tier: Create a new tier
• update_tier: Update an existing tier

Offers Actions

• list_offers: List promotional offers
• read_offer: Get specific offer information
• create_offer: Create a new offer
• update_offer: Update an existing offer

Newsletters Actions

• list_newsletters: List all newsletters
• read_newsletter: Retrieve specific newsletter information
• create_newsletter: Create a new newsletter
• update_newsletter: Update an existing newsletter

Webhooks Actions

• create_webhook: Create a new webhook
• update_webhook: Update an existing webhook
• delete_webhook: Delete a specific webhook

Available Resources

All resources follow the URI pattern: [type]://[id]

• user://{user_id}: User profiles and roles
• member://{member_id}: Member details and subscriptions
• tier://{tier_id}: Tier configurations
• offer://{offer_id}: Offer details
• newsletter://{newsletter_id}: Newsletter settings
• post://{post_id}: Post content and metadata
• blog://info: General blog information

How It Works

The Ghost MCP Server operates by establishing a secure connection to the Ghost Admin API using JWT authentication. It offers a suite of MCP tools that allow users to manage various entities within the Ghost CMS, including posts, users, members, tiers, offers, and newsletters. By integrating with LLM interfaces like Claude, users can perform these management tasks through natural language commands, simplifying the process of content administration.