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:

You:List my recent blog posts
You:Create a new draft post about MCP servers with the category 'AI' and SEO keyword 'mcp server'
You:Publish post cm123abc
You:Check the status of job ce372d00-7d67-4613-bd1d-adc711c35846
You:Update the meta description on my latest post to something more compelling

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-key header
  • Authorization: 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/sdk v1.x
  • Tool annotations: Read-only tools marked with readOnlyHint: true, destructive tools with destructiveHint: 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.