Ghost MCP HTTP Server API Documentation

This HTTP server provides RESTful access to Ghost CMS through the Model Context Protocol (MCP). It includes streaming support for n8n and other automation tools.

Base URL

http://localhost:3000 (or your configured port)

Authentication

Configure your Ghost API credentials via environment variables:

Health & Discovery Endpoints

GET /health

Check server health status

{"status": "healthy", "service": "ghost-mcp-http", "timestamp": "2025-12-12T13:00:00.000Z"}
GET /capabilities

Get server capabilities

GET /tools

List all available tools

GET /resources

List all available resources

Tool Execution

POST /tools/{toolName}

Execute a tool synchronously

Request Body: 
{
  "arguments": {
    "key": "value"
  }
}
Response: 
{
  "success": true,
  "result": [...],
  "isError": false
}
POST /tools/{toolName}/stream

Execute a tool with Server-Sent Events streaming (ideal for n8n)

Request Body: 
{
  "arguments": {
    "key": "value"
  }
}
Stream Events: 
data: {"type": "start", "toolName": "browse-posts"}

data: {"type": "data", "content": {...}, "isError": false}

data: {"type": "complete", "success": true}

Resource Access

GET /resources/{resourceType}/{resourceId?}

Get a specific resource

Examples:

Available Ghost Tools

Posts

Members

Tags

Users, Tiers, Offers, Newsletters, etc.

Similar CRUD operations are available for all Ghost resources. See /tools endpoint for complete list.

Example n8n Usage

In n8n, you can use the HTTP Request node:

  1. Method: POST
  2. URL: http://your-server:3000/tools/browse-posts/stream
  3. Body: JSON with arguments
  4. Headers: Accept: text/event-stream

Docker Support

Environment variables for containerized deployment: