Phantom MCP Gateway

⚠️ Critical Announcement: Replatforming to TypeScript

The entirety of the Ghost MCP Server has undergone a comprehensive migration from Python to TypeScript in the v0.1.0 release. This foundational overhaul yields substantial enhancements:

• Simplified Deployment: Now accessible via the NPM registry as package @fanyangmeng/ghost-mcp.
• Enhanced Operational Integrity: Leverages the official @tryghost/admin-api client, replacing prior custom integration logic.
• Superior Code Quality: TypeScript ensures strong typing and better structural organization.
• Effortless Setup: Configuration is streamlined using standard Node.js environment variables.

Migration Notes (Breaking Changes)

• The requirement for Python dependencies has been entirely eliminated.
• Configuration mechanisms have shifted to rely exclusively on Node.js environment variables.
• Containerized deployment procedures have been made significantly simpler.
• Installation methodology now utilizes NPM exclusively.

Please consult the documentation below for detailed instructions on transitioning from the Python version. Should any difficulties arise during adoption, submitting an issue on the GitHub repository is encouraged.

---

This server adheres to the Model Context Protocol (MCP) standard, acting as a secure bridge between LLM interfaces (such as Claude) and your Ghost blog infrastructure. It furnishes comprehensive tooling for managing all primary CMS assets, encompassing articles, member databases, subscription tiers, promotional offers, and email broadcasts, secured via JWT authorization.

Core Capabilities

• Secure data transactions with Ghost using the official @tryghost/admin-api module.
• Full programmatic control over entities: Posts, Members, Newsletters, Offers, Invites, Roles, Tags, Tiers, Users, and Webhooks.
• Sophisticated retrieval mechanisms supporting both conceptual (fuzzy) and precise (exact) data matching.
• Generation of output data formats that are highly accessible and interpretable by human operators.
• Resilient fault tolerance implemented via proprietary GhostError exception types.
• Built-in instrumentation supporting MCP context logging for advanced diagnostic tracing.

Integration Guide

To integrate this gateway with an MCP-aware client, such as Claude Desktop, insert the following configuration block into your claude_desktop_config.json file:

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

Accessible Ghost Resources

The following data domains within your Ghost CMS are exposed by this MCP service:

• Posts: The collection of articles and content items published on the site.
• Members: Subscriber identities and registered user profiles.
• Newsletters: Configuration and history of outgoing email campaigns.
• Offers: Definition of discount codes and promotional structures.
• Invites: Management of pending invitations for staff or new site participants.
• Roles: Permissions structures assigned to administrative users.
• Tags: Categorization labels applied across content assets.
• Tiers: Defined subscription levels and access plans.
• Users: Accounts belonging to site administrators and staff.
• Webhooks: Configuration for external system event notifications.

Exposed Toolset Summary

This MCP endpoint offers a comprehensive operational toolkit for Ghost CMS administration via the Model Context Protocol. Operations are mapped per resource, generally covering retrieval (browse/read), creation, modification, and deletion workflows. The following summarizes the primary tool categories available:

Posts Operations

• Browse Posts: Retrieve lists of articles, allowing for filtering, sorting, and pagination.
• Read Post: Fetch a specific article using its unique identifier or URL slug.
• Add Post: Initiate the creation of a new draft or published entry.
• Edit Post: Modify attributes of an existing post record.
• Delete Post: Permanently erase a specified post.

Members Operations

• Browse Members: Obtain paginated lists of subscribers, with filtering capabilities.
• Read Member: Look up a member via ID or associated email address.
• Add Member: Register a new user/subscriber.
• Edit Member: Update existing member profile information.
• Delete Member: Remove a member record from the database.

Newsletters Operations

• Browse Newsletters: List available newsletter configurations.
• Read Newsletter: Retrieve details for a specific newsletter instance.
• Add Newsletter: Define a new newsletter entity.
• Edit Newsletter: Modify the parameters of an existing newsletter.
• Delete Newsletter: Archive or remove a newsletter configuration.

Offers Operations

• Browse Offers: List currently defined promotional offers.
• Read Offer: Fetch the details of a particular offer.
• Add Offer: Create a new discount or promotional offer.
• Edit Offer: Update the specifics of an existing offer.
• Delete Offer: Deactivate or remove an offer.

Invites Operations

• Browse Invites: View all outstanding invitations.
• Add Invite: Generate a new invitation token/record.
• Delete Invite: Revoke an existing, unused invitation.

Roles Operations

• Browse Roles: List all defined user roles and their associated permissions.
• Read Role: Retrieve the definition for a specific role ID.

Tags Operations

• Browse Tags: Retrieve a listing of all content tags.
• Read Tag: Fetch a tag based on its identifier or slug.
• Add Tag: Establish a new organizational tag.
• Edit Tag: Modify the metadata of an existing tag.
• Delete Tag: Remove a tag from the system.

Tiers Operations

• Browse Tiers: List all defined subscription tiers/plans.
• Read Tier: Retrieve the configuration for a specific tier ID.
• Add Tier: Define a new membership tier.
• Edit Tier: Update the attributes of an existing tier.
• Delete Tier: Decommission a subscription tier.

Users Operations

• Browse Users: List all administrative and staff user accounts.
• Read User: Fetch user details using ID or unique username/slug.
• Edit User: Update information pertaining to a user account.
• Delete User: Remove a user account (where permitted).

Webhooks Operations

• Browse Webhooks: List configured external notification endpoints.
• Add Webhook: Establish a new event notification listener.
• Delete Webhook: Terminate a configured webhook endpoint.

Every function described above is exposed and callable via the Model Context Protocol interface when utilized by compatible client applications. Precise input schemas and argument definitions are documented within the source code located in src/tools/.

Exception Management

The Phantom MCP Gateway utilizes a custom exception structure, GhostError, to provide precise, descriptive feedback concerning API communication failures or internal processing exceptions, greatly aiding in rapid problem diagnosis.

Collaboration Guidelines

1. Create a personal fork of this repository.
2. Establish a dedicated branch for your intended feature.
3. Submit your proposed modifications via a commit.
4. Initiate a formal pull request for review.

Licensing

This software is distributed under the terms of the MIT License.

WIKIPEDIA: Cloud computing is characterized by five core attributes as defined by NIST in 2011: on-demand self-service, broad network accessibility, resource abstraction via pooling, rapid elasticity to meet fluctuating demand, and metered service delivery for transparent resource consumption tracking. ISO has since refined these concepts. The foundational ideas trace back to 1960s time-sharing systems. The term 'cloud' for abstract network services emerged around 1994, popularized by General Magic's Telescript environment, and gained wider industry recognition in 1996 through early business planning at Compaq Computer Corporation, which envisioned a future reliant on ubiquitous, scalable internet-based computational power.