How to Use the Ghost (Publishing & Newsletter Platform API) MCP in OpenAI Agents SDK

Q: How do I connect the Ghost (Publishing & Newsletter Platform API) to the OpenAI Agents SDK?

Install openai-agents via pip. Initialize MCPServerStreamableHttp with your Vinkius endpoint URL and pass it to your Agent constructor's mcpservers list. The SDK automatically discovers all 16 Ghost tools.

Q: Can the OpenAI Agents SDK filter tags with the Ghost (Publishing & Newsletter Platform API)?

Yes. The contentlisttags tool supports NQL filtering. Your agent can query specific internal tags to organize content without manual intervention.

Q: Does the Ghost (Publishing & Newsletter Platform API) allow my OpenAI Agents SDK system to delete posts?

It does. The admindeletepost tool removes content from your database. You should configure OpenAI's built-in guardrails to require human confirmation before the agent executes this specific action.

Q: How do I manage subscription offers with this MCP server?

Your agent calls adminlistoffers to read active discounts and promotional links. It can then inject those exact offer details into the newsletters it drafts.

Q: How does this MCP Server handle my subscriber data privacy?

When your agent calls adminlistmembers, it reads email addresses and subscription statuses. Vinkius runs this operation inside an ephemeral V8 isolate sandbox. The connection terminates instantly after the API call, leaving no persistent data behind.

Connect the Ghost (Publishing & Newsletter Platform API) MCP Server to your OpenAI Agents SDK to safely automate newsletters and manage paid members.

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 OpenAI Agents SDK

Create your Vinkius account to connect Ghost (Publishing & Newsletter Platform API) to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate publishing with OpenAI Agents SDK

Your deployed agents can write and stage content directly in your Ghost publication. Using `admin_create_post` and `admin_update_post`, the agent formats text, applies tags, and saves drafts for editorial review. OpenAI's built-in guardrails ensure the agent never accidentally pushes a draft live without explicit approval. You control the exact boundary of what the agent can do. If you want a specialized agent just for proofreading, it can read existing content via `admin_list_posts`, suggest edits, and hand off the final publication step to a human editor. The entire execution path gets logged in your OpenAI dashboard for auditing.

Handle members and subscription tiers

Connect your audience growth logic directly to your agent system. When a new user signs up on another platform, your agent triggers `admin_create_member` to sync their profile into Ghost. It can assign specific tags or assign them to paid groups by reading active options through `content_list_tiers`. You don't have to manually reconcile databases. The MCP Server lets your agent check existing subscriber details with `admin_list_members` before creating duplicates. This keeps your member list clean while your agent handles the repetitive data entry.

Query site settings and authors

Agents need context to write in your brand voice. The `content_list_authors` and `content_get_settings` tools pull down your site's public configuration and writer profiles. Your agent reads this data to match the exact tone and formatting rules you already established. The agent filters large archives using NQL via `content_list_posts`. Instead of pulling the whole database, it grabs exactly what it needs to reference past articles. OpenAI handles the tool discovery automatically when you pass the server context.

Setup guide

Set up Ghost (Publishing & Newsletter Platform API) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Ghost (Publishing & Newsletter Platform API) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Ghost (Publishing & Newsletter Platform API) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Ghost (Publishing & Newsletter Platform API) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Ghost (Publishing & Newsletter Platform API) Agent",
            instructions="You have access to Ghost (Publishing & Newsletter Platform API) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Install `openai-agents` via pip. Initialize `MCPServerStreamableHttp` with your Vinkius endpoint URL and pass it to your Agent constructor's `mcp_servers` list. The SDK automatically discovers all 16 Ghost tools.

Yes. The `content_list_tags` tool supports NQL filtering. Your agent can query specific internal tags to organize content without manual intervention.

It does. The `admin_delete_post` tool removes content from your database. You should configure OpenAI's built-in guardrails to require human confirmation before the agent executes this specific action.

Your agent calls `admin_list_offers` to read active discounts and promotional links. It can then inject those exact offer details into the newsletters it drafts.

When your agent calls `admin_list_members`, it reads email addresses and subscription statuses. Vinkius runs this operation inside an ephemeral V8 isolate sandbox. The connection terminates instantly after the API call, leaving no persistent data behind.

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