Ghost Publisher MCP server
io.github.BlogFactoryHQ/ghost-publisher·v0.10.1Local-first MCP server for safe Ghost authoring, diagnostics, scheduling, and publishing.
0 stars128 downloads/wk
Reviews
Write oneNobody has reviewed Ghost Publisher yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Ghost Publisher tools (20, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
apply_change_setRe-read and preflight the exact previewed batch, require an exact site-bound preview hash plus exact approval scopes, save a Ghost revision for every edit, verify readback, and stop after the first remote failure.
audit_contentInspect up to 25 exact posts or Pages for parseability, Lexical/card inventory, missing alt text and metadata, lengths, links, and a Sources/Kaynaklar heading. It does not crawl, score quality, or judge sources.
check_connectionVerify Ghost authentication and report which optional features are configured without exposing secrets.
check_live_pagesRead exact current published pages, select each public URL from Ghost or GHOST_PUBLIC_PAGE_URL_TEMPLATE, and verify HTTP status, title, canonical URL, and configured SEO metadata once.
check_live_postsCheck configured public URLs once and verify HTTP status, expected title text, and any supplied rendered SEO metadata.
check_site_healthCheck server-selected Ghost and delivery surfaces, exact published targets, canonicals, share prerequisites, and Ghost-returned feature images without crawling or writing.
create_draftswrite actionCreate 1–10 posts as drafts from either Markdown or bounded native Ghost blocks, including formatted prose, lists, quotes, code, uploaded-image cards, and bookmarks. Image-card src values must come from upload_image in this server session. This tool cannot publish. Ordered tags preserve the primary tag.
create_page_draftswrite actionCreate 1–10 pages from either Markdown or bounded native Ghost blocks and always force draft status. Image-card src values must come from upload_image in this server session. Tags, authors, templates, code injection, and scheduling are unavailable.
get_pageGet one page by exact Ghost ID or slug, including HTML, Lexical content, and complete SEO and social metadata.
get_postwrite actionGet one post by its exact Ghost ID or slug, including HTML, Lexical content, and complete SEO and social metadata.
list_authorsList bounded public author identities and post counts without exposing staff email or roles.
list_pagesList bounded Ghost page records and obtain exact IDs plus updated_at values.
list_postsList concise Ghost post records. Use this before updating or publishing to obtain exact IDs and updated_at values.
list_tagsList Ghost tags with post counts.
plan_scheduleConvert an ordered draft list and IANA local start time into exact UTC timestamps with an HMAC-bound plan. This tool never writes, emails, deploys, or claims headless visibility.
preview_changesRead up to 25 exact posts or Pages and return full before snapshots, field and Lexical impact, required approval scopes, and a site-bound stateless preview hash. This tool never writes.
schedule_postsSchedule exact current drafts for future web publication. Requires user_confirmed=true and never sends newsletters or triggers deployment.
trigger_deploywrite actionPOST exactly once to the configured deployment hook after user_confirmed=true. The hook URL cannot be supplied by the caller and failures are never retried automatically.
unschedule_postsReturn exact current scheduled posts to draft. Requires user_confirmed=true and never triggers deployment.
upload_imagewrite actionUpload a local image inside GHOST_UPLOAD_ROOTS, including images generated by the AI client. Remote URLs, SVG, symlink escapes, and files over 20 MB are refused.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan10 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 67 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
How Ghost Publisher compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 77/100
- higher than 50% of 48,255 servers
- Tools
- 20
- the typical server has 7
- Tools that change things
- 25%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 128
- more than 68% of 12,191 servers with a package
What its tools let an agent do: 14 read · 3 create · 1 change · 2 run or deploy
Install Ghost Publisher in Claude Code, Cursor or VS Code
Runs npx -y ghost-publisher-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ghost-publisher -- npx -y ghost-publisher-mcp
What the publisher says
From the Ghost Publisher repository's README, as published. We do not edit it. Read it on GitHub
Ghost Publisher MCP
Write with your AI. Publish safely to Ghost.
An unofficial, local-first MCP server for creating and managing Ghost posts and Pages, diagnosing publication readiness, scheduling posts, uploading images, publishing approved batches, triggering static-site rebuilds, and verifying rendered content.
Ghost Publisher exposes a bounded editorial surface instead of mirroring the full Ghost Admin API. It has no delete, member, newsletter-send, theme, arbitrary-query, remote HTTP, OAuth, or built-in AI billing surface.
Ghost Publisher is maintained by BlogFactoryHQ and works independently. BlogFactory is the separate multi-site, draft-only control plane; Ghost Publisher is the local Ghost-specific server for separately approved scheduling and publishing. Installing one does not install or authorize the other.
Read the official overview and installation guide.
This project is not affiliated with or endorsed by the Ghost Foundation.
Current npm and official MCP Registry release: 0.10.1, published on 2026-08-25.
On 2026-08-16, setup discovery and a redacted dry run passed with ChatGPT desktop 26.810.41047 and its bundled Codex CLI 0.148.0-alpha.9; a read-only connection check reached Ghost 6.42. Cursor and Claude Desktop configuration generation is automated, but their current application runtimes were unavailable on the verification host. Please use the client compatibility issue form for redacted reports and never include an Admin key.
Proven in a daily publishing workflow
Ortak Alan uses Ghost Publisher in its maintainer-operated daily workflow across a 336-piece public archive. The team creates drafts, corrects metadata, uploads images, publishes approved batches, deploys once, and verifies the live result—at a reported cadence of five to six posts a day.
The manual version of that path took roughly 30 minutes per post. The operator now completes reviewed batches in minutes without dropping draft-first creation or public-result checks. During this publishing period, Search Console recorded 652 clicks and 65,000 impressions over three months; its latest captured 28-day view showed 500 clicks (+294%) and 51,900 impressions (+369%). This is operational outcome evidence, not a claim that this MCP alone caused organic growth. Read the full Ortak Alan case study.
Requirements
- Node.js 22 or newer
- A Ghost custom integration Admin API key
- Optional: a deploy hook and public post/page URL templates for headless/static sites
Create a custom integration in Ghost Admin → Settings → Integrations, then copy its Admin API key.
One-command setup
Watch the silent 60-second setup tour (4K, 60 fps).
Run this in a private terminal:
npx -y ghost-publisher-mcp@latest setup --url https://your-ghost.example.comShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Ghost Publisher: common questions
- Is Ghost Publisher MCP server safe?
- Mostly: it is graded B (77/100). Read the Ghost Publisher safety report
- How do I install Ghost Publisher?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Ghost Publisher need an API key?
- Yes. The registry entry asks for
GHOST_ADMIN_API_KEY,GHOST_DEPLOY_HOOK_URL. - Is Ghost Publisher maintained?
- The last commit was 71 days ago (2026-08-25). The latest release is v0.10.1.
- How does Ghost Publisher compare with other MCP servers?
- safety score 77/100 (higher than 50% of 48,255 servers); tools 20 (the typical server has 7); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.