MCP Server

Remote MCP server for Onepostly — publish, schedule, and measure from any MCP client.

Onepostly provides a remote MCP server over Streamable HTTP.

https://mcp.onepostly.com

https://mcp.onepostly.com/mcp is also available as an alias.

Authentication

Authenticate with a workspace API key. Create one in Dashboard → Settings → API keys.

Authorization: Bearer op_YOUR_KEY

x-api-key: op_YOUR_KEY

For clients that cannot set headers (e.g., Claude.ai web), use the query parameter:

https://mcp.onepostly.com?access_key=op_YOUR_KEY

read_only keys can call list_* and get_* tools; write tools return FORBIDDEN.

Tools

Tool	Description
`list_connections`	List connected accounts (filter by `platform`)
`publish_post`	Publish immediately — all platforms, per-platform validation, wallet debit
`schedule_post`	Schedule for future (`scheduledFor` wall time + `timezone`)
`list_posts`	List posts, newest first
`get_post_status`	Get post and destination statuses
`get_insights`	Get normalized metrics for a post
`delete_post`	Delete a published destination
`get_pinterest_boards`	List Pinterest boards (call before publishing to Pinterest)
`get_tiktok_creator_info`	Get TikTok creator privacy options (call before publishing to TikTok)

publish_post and schedule_post share the same validation as POST /v1/posts. X usage is billed pass-through from your wallet. 402 INSUFFICIENT_WALLET means top up in Settings → Billing.

Connect

Claude Desktop, Claude Code, Cursor

{
  "mcpServers": {
    "onepostly": {
      "url": "https://mcp.onepostly.com",
      "headers": {
        "Authorization": "Bearer op_YOUR_KEY"
      }
    }
  }
}

Claude.ai (web)

Paste the URL with ?access_key:

https://mcp.onepostly.com?access_key=op_YOUR_KEY

Inspector

npx @modelcontextprotocol/inspector@latest

URL: https://mcp.onepostly.com
Header: Authorization: Bearer op_YOUR_KEY
Header: MCP-Protocol-Version: 2025-11-25

Examples

List connections

tool: list_connections

Publish

{
  "tool": "publish_post",
  "arguments": {
    "text": "Hello from Onepostly",
    "destinations": [{ "connectionId": "YOUR_CONNECTION_ID" }]
  }
}

Schedule

{
  "tool": "schedule_post",
  "arguments": {
    "text": "Hello tomorrow",
    "scheduledFor": "2026-08-10T09:00:00",
    "timezone": "America/New_York",
    "destinations": [{ "connectionId": "YOUR_CONNECTION_ID" }]
  }
}

Protocol

Transport: Streamable HTTP (POST JSON-RPC 2.0).
Version: 2025-11-25 (MCP-Protocol-Version header and params._meta["io.modelcontextprotocol/protocolVersion"]).
Discovery: server/discover returns supportedVersions and capabilities.

Notes

No server-initiated notifications; poll get_post_status or use webhooks.
Rate and wallet limits are identical to the REST API.

On this page