Onepostly MCP

MCP Server

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

Copy Markdown

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:

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.

Introduction

One API for all social media.

Quickstart

Publish your first post with an API key.