This Ghost MCP Server exposes Ghost CMS management operations as MCP tools. It implements 34 tools across seven resource types (tag, post, page, member, newsletter, tier, and image handling) that allow an MCP client to create, read, update, delete, and search Ghost content and configurations. Once the server is running (default at http://localhost:3001/), an MCP client can discover available resources and tools via the root endpoint and begin issuing tool invocations such as ghost_create_post, ghost_update_tag, ghost_get_pages, ghost_search_members, or ghost_upload_image to manage a Ghost blog programmatically. The tools mirror the Ghost Admin API surface and support common operations like creating posts with HTML content and metadata, uploading images for use in content, managing tags and pages, handling members and newsletters, and configuring memberships and plans.

Prerequisites:

• Node.js 18.x or higher installed on your system
• Access to a Ghost Admin API URL and a valid Admin API key
• Git to clone the repository (optional but recommended)

1. Clone the repository git clone https://github.com/jgardner04/Ghost-MCP-Server.git cd Ghost-MCP-Server

2. Install dependencies npm install

3. Configure environment variables Create a .env file or export variables in your environment with the following values:

   • GHOST_ADMIN_API_URL: Your Ghost Admin API URL (e.g., https://your-ghost-site.com/ghost/api/admin)
   • GHOST_ADMIN_API_KEY: Your Ghost Admin API key

4. Run the MCP server npm run start

   or if you run directly via node

   node src/server.js

5. Verify the server is running Open http://localhost:3001/ in your browser or call the MCP discovery endpoint to confirm the server exposes its capabilities.

Tips and common considerations:

• Ensure the Ghost Admin API URL is reachable from the MCP server host and that the Admin API key has sufficient permissions for the desired operations.
• The MCP server typically exposes a root discovery endpoint (e.g., http://localhost:3001/) where clients can retrieve the capabilities and available tools.
• If you change the Ghost API URL or credentials, restart the MCP server to apply the new configuration.
• For image handling (ghost_upload_image), the service expects a publicly accessible image URL. The tool will upload and return the Ghost image URL for use in content.
• When creating posts or pages with complex content, use the html field to include your content structure and media embeds. SEO fields like meta_title and meta_description are optional but recommended for better search visibility.
• Review rate limits or permission constraints of your Ghost installation, as some operations may be restricted by role or API usage limits.