# Ghost API MCP

> Ghost Publishing Platform API MCP lets your AI agent manage everything from site settings to newsletters. You can browse public content, create new drafts, and handle member accounts without ever logging into the Ghost dashboard. It’s total control over your entire publishing workflow, directly through natural conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** blogging, newsletter, publishing, ghost-cms, api-automation

## Description

This connector gives your AI client full access to run your Ghost CMS like it's a backend service. You stop hopping between tabs and start managing content from one chat window. Need to check site details or find all authors? Your agent handles that via the Content API, pulling public data instantly. Want to update a draft post or delete an old piece of content? The Admin API lets you write those changes directly. This means your AI can orchestrate complex publishing strategies—like checking existing tags and then drafting new content around them. It's all available right here on Vinkius, making it one place for every part of your marketing stack.

## Tools

### admin_create_member
Create a new member via Ghost Admin API

### admin_create_post
Create a new post via Ghost Admin API

### admin_delete_post
Delete a post via Ghost Admin API

### admin_list_members
Browse members via Ghost Admin API

### admin_list_newsletters
Browse newsletters via Ghost Admin API

### admin_list_offers
Browse subscription offers via Ghost Admin API

### admin_list_pages
Browse pages via Ghost Admin API

### admin_list_posts
Browse posts via Ghost Admin API

### admin_list_webhooks
Browse system webhooks via Ghost Admin API

### admin_update_post
Update an existing post via Ghost Admin API

### content_list_authors
Supports NQL filtering and pagination.

Browse or read public authors via Ghost Content API

### content_list_pages
Supports NQL filtering and pagination.

Browse or read public pages via Ghost Content API

### content_list_posts
Supports NQL filtering, pagination, and inclusion of related data.

Browse or read public posts via Ghost Content API

### content_get_settings
Fetch site settings via Ghost Content API

### content_list_tags
Supports NQL filtering and pagination.

Browse or read public tags via Ghost Content API

### content_list_tiers
Browse membership tiers via Ghost Content API

## Prompt Examples

**Prompt:** 
```
List the 5 most recent public posts from my Ghost blog.
```

**Response:** 
```
I've retrieved the latest posts. The most recent ones are 'The Future of AI', 'Ghost vs WordPress', and 'Mastering MCP'. Would you like to see the full content of any of these?
```

**Prompt:** 
```
Create a new draft post titled 'Weekly Newsletter' with some placeholder HTML content.
```

**Response:** 
```
Draft created successfully! The post 'Weekly Newsletter' (ID: 65f2a...) is now in your Ghost admin panel as a draft.
```

**Prompt:** 
```
What are the active membership tiers on my site?
```

**Response:** 
```
I found 2 active tiers: 'Free' and 'Premium ($5/mo)'. Both are currently available for new signups.
```

## Capabilities

### Manage Posts and Pages
Create, update, delete, or list both public articles and internal pages.

### Handle Membership Data
Browse current members and manage site subscription offers.

### Gather Site Information
Retrieve global settings, including titles, descriptions, and active membership tiers for the site.

### Discover Content Metadata
List authors, tags, and all available content types using advanced filtering.

## Use Cases

### The Weekly Newsletter Prep
A content manager needs to write a newsletter that references three specific topics. They ask their agent to run `content_list_tags` first, check for related authors using `content_list_authors`, and then use the gathered data to structure and draft a new post via `admin_create_post`.

### Auditing Site Access
An admin wants to see who has paid access. They ask their agent to run `content_list_tiers` to verify the current payment structure, and then use `admin_list_members` to confirm which users belong to the 'Premium' tier.

### Updating Outdated Content
An editor finds an old post that needs a title change. Instead of opening the dashboard, they ask their agent to use `admin_list_posts` to find the ID, and then call `admin_update_post` with the new metadata.

### Initial Content Audit
A developer needs a baseline of all public content. They instruct their agent to use `content_list_posts`, applying NQL filters to pull only drafts that haven't been touched in 90 days.

## Benefits

- Never manually navigate to the post editor. Use `admin_create_post` or `content_list_posts` to draft and manage articles directly through conversation.
- Stop guessing what data exists. Run `content_list_tags` or `content_list_authors` to instantly see all available metadata for content organization.
- Maintain brand consistency by fetching site details using `content_get_settings`. This verifies titles, descriptions, and global parameters before you publish anything.
- Simplify user management. You can list users with `admin_list_members` or check what subscription options are active using `admin_list_offers`, all in one query.
- Speed up development cycles. Developers use this MCP to run `admin_list_webhooks` and check the full structure of pages (`admin_list_pages`) without needing SSH access.

## How It Works

The bottom line is, you give your AI client credentials once; after that, it handles every content operation for you.

1. Subscribe to this MCP and enter your Ghost Admin Domain, Content API Key, and Admin Token.
2. Connect the MCP to your preferred AI client (Claude, Cursor, etc.) via Vinkius.
3. Tell your agent exactly what you want done—for example, 'List all drafts tagged 'Q3 Marketing' that need review.' — and it executes the command.

## Frequently Asked Questions

**How do I use the admin_list_posts tool with Ghost API MCP?**
Use `admin_list_posts` to get a list of posts. You can pass filters, like date ranges or status (draft/published), to narrow down your search quickly.

**Can I create new members using the admin_create_member tool?**
Yes, `admin_create_member` lets you programmatically add a user account. You'll need to provide all required details like email and role when calling this tool.

**What is content_list_tags for in the Ghost API MCP?**
`content_list_tags` allows you to read every single tag on your site. This is key for running internal audits or ensuring new drafts are correctly categorized.

**Does admin_update_post change published content immediately?**
Yes, `admin_update_post` changes the post data directly in Ghost. Always confirm you have the correct ID and desired status before running this tool.

**Before running any command, how do I authenticate my connection for content_get_settings?**
You must provide your Ghost Admin Domain, Content API Key, and Admin Token during setup. The MCP uses these credentials to authorize every call, ensuring your agent can access the site's global settings.

**When I use content_list_posts, are the results public or private?**
The `content_list_posts` tool retrieves only publicly visible data. If you need to work with drafts or unpublished posts, you must call an Admin API function directly.

**If I use admin_delete_post on a popular article, is there any warning about breaking links?**
The tool executes the deletion immediately. While it handles the post removal, it doesn't manage external linking; you'll need to verify internal site connections yourself.

**How do I handle pagination when content_list_authors returns thousands of records?**
The tool supports NQL filtering and pagination controls. You must specify the page size or use cursor-based limits in your query to prevent overwhelming the API.

**Can I create and publish a new post directly using this integration?**
Yes! You can use the `admin_create_post` tool. You can specify the title, HTML content, and status (e.g., 'draft' or 'published') to manage your content lifecycle.

**How do I filter posts by a specific tag or author?**
You can use the `filter` parameter in tools like `content_list_posts`. Ghost uses NQL (Netvibe Query Language), so you can pass strings like `tag:news` or `author:john` to narrow down your results.

**Does this server support viewing private site settings?**
The `content_get_settings` tool retrieves public site settings like the title, description, and logo. For more sensitive administrative data, the Admin API tools provide access based on your provided Admin Token.