How to Use the Ghost (Publishing & Newsletter Platform API) MCP in Pydantic AI

Q: How do I configure the Ghost (Publishing & Newsletter Platform API) in Pydantic AI?

Install pydantic-ai-slimmcp. Initialize an MCPToolset with your Vinkius HTTP endpoint. Pass this toolset to your Agent constructor to activate the Ghost tools.

Q: Does Pydantic AI support NQL filtering with the Ghost (Publishing & Newsletter Platform API)?

Yes. Tools like contentlistpages accept NQL strings. You can define a Pydantic model for the query parameters to ensure the agent formats the NQL syntax correctly.

Q: What happens if the agent tries to delete a post incorrectly?

If the agent passes the wrong ID format to admindeletepost, Pydantic AI catches the type mismatch. The framework stops execution before the bad request reaches your Ghost instance.

Q: How is my Ghost site configuration protected during execution?

Tools like contentgetsettings expose your site's core metadata. Vinkius routes these requests through a stateless execution environment. Once the Pydantic AI agent receives the response, the server spins down, ensuring no configuration data lingers in memory.

Strictly validate every Ghost (Publishing & Newsletter Platform API) MCP Server response in Pydantic AI to guarantee perfect newsletter formatting.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ghost (Publishing & Newsletter Platform API) MCP to Pydantic AI

Create your Vinkius account to connect Ghost (Publishing & Newsletter Platform API) to Pydantic AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Ghost (Publishing & Newsletter Platform API) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Write posts with strict validation

Ghost requires specific payload structures for its editor. When your agent calls `admin_create_post`, Pydantic AI forces the output to match your defined schemas. If the agent hallucinates a field or breaks the HTML structure, the framework throws a loud validation error immediately. You never push corrupted data to your database. The agent can read existing formatting via `admin_list_posts`, draft a new article, and attempt to save it. Pydantic AI intercepts the request, checks the types, and rejects bad payloads before they hit the MCP Server.

Sync members via MCP Server

Audience management requires exact data types. Your agent uses `admin_create_member` to add subscribers and `admin_list_members` to verify their status. Because Pydantic AI validates every response, you know exactly what fields are coming back from the Ghost API. If Ghost changes its response format for `content_list_tiers`, your code catches it at runtime. You build reliable synchronization scripts that never silently fail or mangle subscriber records in your database.

Audit webhooks and site settings

Keep your publication's infrastructure secure. The agent calls `admin_list_webhooks` to check for unauthorized integrations. It cross-references the active hooks against your approved list, failing loudly if it finds a mismatch. It also monitors configuration drift. By calling `content_get_settings`, the agent verifies your site title, description, and navigation links. Pydantic AI guarantees the agent parses this settings object correctly, regardless of which underlying LLM you use.

Setup guide

Set up Ghost (Publishing & Newsletter Platform API) MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "ghost-publishing-newsletter-platform-api-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Ghost (Publishing & Newsletter Platform API) tools.",
)

result = await agent.run("List recent Ghost (Publishing & Newsletter Platform API) transactions")
print(result.output)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Ghost. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Ghost (Publishing & Newsletter Platform API) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Ghost (Publishing & Newsletter Platform API) MCP in Pydantic AI

Install `pydantic-ai-slim[mcp]`. Initialize an `MCPToolset` with your Vinkius HTTP endpoint. Pass this toolset to your Agent constructor to activate the Ghost tools.

Yes. Tools like `content_list_pages` accept NQL strings. You can define a Pydantic model for the query parameters to ensure the agent formats the NQL syntax correctly.

You can. Pydantic AI is model-agnostic. You can run a local model, connect it to the MCP server, and manage your Ghost publication without sending prompts to commercial AI providers.

If the agent passes the wrong ID format to `admin_delete_post`, Pydantic AI catches the type mismatch. The framework stops execution before the bad request reaches your Ghost instance.

Tools like `content_get_settings` expose your site's core metadata. Vinkius routes these requests through a stateless execution environment. Once the Pydantic AI agent receives the response, the server spins down, ensuring no configuration data lingers in memory.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript