MCP Server
Notipo exposes a Model Context Protocol (MCP) server that lets AI agents create, publish, and manage WordPress posts through natural language. Claude Desktop, Cursor, Windsurf, and any MCP-compatible agent can use Notipo as a tool.
How It Works
The MCP server runs at POST /api/mcp and exposes 12 tools that map to the Notipo REST API. When an AI agent connects, it discovers these tools automatically and can call them to manage your WordPress content — no custom code needed.
The server uses Streamable HTTP transport in stateless mode. Authentication uses the same API key as the REST API.
Setup
Claude Desktop
Add this to your Claude Desktop config file (~/.claude.json or project .mcp.json):
{
"mcpServers": {
"notipo": {
"type": "http",
"url": "https://notipo.com/api/mcp",
"headers": {
"x-api-key": "your-api-key"
}
}
}
}Claude Code CLI
claude mcp add --transport http notipo https://notipo.com/api/mcp \
--header "x-api-key: your-api-key"Self-hosted
Replace the URL with your instance:
{
"mcpServers": {
"notipo": {
"type": "http",
"url": "https://your-domain.com/api/mcp",
"headers": {
"x-api-key": "your-api-key"
}
}
}
}Available Tools
The MCP server exposes 12 tools. Read-only tools are annotated so agents can call them freely without confirmation prompts.
| Tool |
|---|
list_posts |
get_post |
create_post |
update_post |
publish_post |
delete_post |
list_categories |
list_tags |
get_job |
list_jobs |
get_settings |
sync_now |
Example
Once connected, you can ask your AI agent things like:
The agent will call the appropriate Notipo tools, handle the pipeline automatically, and report back with results.
Authentication
The MCP server accepts the same API key as the REST API. Pass it via either:
x-api-keyheaderAuthorization: Bearer <key>header
Get your API key from Settings → Account in the Notipo dashboard, or via the login endpoint.
Technical Details
- Endpoint:
POST /api/mcp - Protocol: MCP over Streamable HTTP (stateless, no sessions)
- SDK:
@modelcontextprotocol/sdkv1.x - Tool annotations: Read-only tools marked with
readOnlyHint: true, destructive tools withdestructiveHint: true
MCP vs REST API
The MCP server calls the same code as the REST API — same validation, same plan checks, same job queue. Use MCP when your client is an AI agent that benefits from automatic tool discovery. Use the REST API or CLI for scripts and automation workflows.