Developers · MCP

Model Context Protocol (MCP)

Let AI assistants interact with your SocialPlod workspace through MCP tools — list posts, schedule content, fetch insights, and more using the same OAuth bearer tokens as the REST API.

MCP capabilities

  • Streamable HTTP transport (JSON-RPC 2.0)
  • Same OAuth bearer tokens as the REST API
  • Tools for posts, accounts, media, insights, and workflows
  • Compatible with Cursor and Claude Desktop remote MCP configs
  • Workspace-scoped — actions run in your active workspace context

MCP endpoint

URL: https://socialplod.com/api/v1/mcp

Transport: Streamable HTTP with JSON-RPC 2.0. Authenticate with the same OAuth bearer token used for the REST API.

Example client config

{
    "mcpServers": {
        "socialplod": {
            "url": "https://socialplod.com/api/v1/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_ACCESS_TOKEN"
            }
        }
    }
}

Compatible clients

  • Cursor IDE (remote MCP server config)
  • Claude Desktop (HTTP MCP transport)
  • Any MCP client supporting Streamable HTTP + Bearer auth

Available tools

  • list_posts — List posts in the active workspace. Optional filters: status, q (search), page, per_page.
  • get_post — Get a single post by ID with platform targets and media.
  • schedule_post — Create and schedule a new post to one or more connected accounts.
  • publish_post_now — Create and publish a post immediately to selected accounts.
  • duplicate_post — Duplicate a published post into a new draft.
  • list_accounts — List connected social accounts in the workspace.
  • insights_summary — Get workspace publishing summary counts.
  • list_media — List media library files for the workspace owner.
  • run_workflow — Run a workflow manually by ID.

Frequently asked questions

Is MCP included with API access?

Yes. MCP uses the same plan entitlement as the REST API — one upgrade unlocks both.

Where do I get setup instructions after signup?

Open the MCP hub in your workspace after subscribing to an eligible plan. It includes a ready-to-copy config snippet for Cursor and Claude Desktop.