Ghost MCP Server for Pydantic AIGive Pydantic AI instant access to 10 tools to Create Post, Get Post Details, Get Site Settings, and more
Pydantic AI brings type-safe agent development to Python with first-class MCP support. Connect Ghost through Vinkius and every tool is automatically validated against Pydantic schemas. catch errors at build time, not in production.
Ask AI about this App Connector for Pydantic AI
The Ghost app connector for Pydantic AI is a standout in the Productivity category — giving your AI agent 10 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
agent = Agent(
model="openai:gpt-4o",
mcp_servers=[server],
system_prompt=(
"You are an assistant with access to Ghost "
"(10 tools)."
),
)
result = await agent.run(
"What tools are available in Ghost?"
)
print(result.data)
asyncio.run(main())
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Ghost MCP Server
Connect your Ghost publishing account to any AI agent and take full control of your content management and membership workflows through natural conversation.
Pydantic AI validates every Ghost tool response against typed schemas, catching data inconsistencies at build time. Connect 10 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
What you can do
- Content Orchestration — List and manage all blog posts (published, draft, scheduled) and retrieve detailed HTML content and metadata programmatically
- Member Intelligence — Query your subscriber directory and retrieve detailed profiles, including join dates and membership tiers to monitor audience growth
- Site Navigation — List and oversee static site pages (About, Contact) and manage content tags to maintain a perfectly organized site taxonomy
- Publishing Control — Create new posts or drafts and update publishing statuses directly through your agent to streamline your editorial pipeline
- Site Visibility — Retrieve general site settings, newsletter configurations, and active membership offers using natural language commands
The Ghost MCP Server exposes 10 tools through the Vinkius. Connect it to Pydantic AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 10 Ghost tools available for Pydantic AI
When Pydantic AI connects to Ghost through Vinkius, your AI agent gets direct access to every tool listed below — spanning blogging, newsletter-publishing, membership-sites, and more. Every call is secured with network, filesystem, subprocess, and code evaluation entitlements inside a sandboxed runtime. Beyond a simple connection, you get a full AI Gateway with real-time visibility into agent activity, enterprise governance, and optimized token usage.
Requires a title and supports optional HTML content. The post is created as a "draft" by default but can be set to "published" immediately. Create a new Ghost post or draft
Essential for reviewing the full content of an article. Get details for a specific post
Essential for verifying site identity. Get Ghost site settings and configuration
Includes emails, status, and join dates. List all site members
g., Free, Premium) available on the site. Useful for understanding the subscription structure. List membership tiers and plans
Newsletters are used to send content updates to members. List all configured newsletters
List active membership offers
g., About, Contact) defined on the Ghost site. Pages are similar to posts but used for non-blog content. List all static site pages
Includes basic metadata and post IDs for detailed retrieval. List all Ghost blog posts
Useful for organizing and filtering posts. List all content tags
Connect Ghost to Pydantic AI via MCP
Follow these steps to wire Ghost into Pydantic AI. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.
Install Pydantic AI
pip install pydantic-aiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.py and run: python agent.pyExplore tools
Why Use Pydantic AI with the Ghost MCP Server
Pydantic AI provides unique advantages when paired with Ghost through the Model Context Protocol.
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Ghost integration code
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
Dependency injection system cleanly separates your Ghost connection logic from agent behavior for testable, maintainable code
Ghost + Pydantic AI Use Cases
Practical scenarios where Pydantic AI combined with the Ghost MCP Server delivers measurable value.
Type-safe data pipelines: query Ghost with guaranteed response schemas, feeding validated data into downstream processing
API orchestration: chain multiple Ghost tool calls with Pydantic validation at each step to ensure data integrity end-to-end
Production monitoring: build validated alert agents that query Ghost and output structured, schema-compliant notifications
Testing and QA: use Pydantic AI's dependency injection to mock Ghost responses and write comprehensive agent tests
Example Prompts for Ghost in Pydantic AI
Ready-to-use prompts you can give your Pydantic AI agent to start working with Ghost immediately.
"List all my draft posts in Ghost."
"Create a new draft titled 'Welcome to our MCP Blog'."
"Show me a list of all site members and their emails."
Troubleshooting Ghost MCP Server with Pydantic AI
Common issues when connecting Ghost to Pydantic AI through the Vinkius, and how to resolve them.
MCPServerHTTP not found
pip install --upgrade pydantic-aiGhost + Pydantic AI FAQ
Common questions about integrating Ghost MCP Server with Pydantic AI.
How does Pydantic AI discover MCP tools?
MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.