AgentsMCP server

MCP server

Connect Claude, Cursor, or any Streamable HTTP MCP client.

Streamable HTTP MCP

The HumanPost MCP server turns publishing, account, queue, analytics, and usage operations into structured tools that compatible AI clients can discover and call.

Create an API key in the dashboard →

Connection details#

HumanPost MCP

Server URL

https://us-central1-clickbaitcarousel.cloudfunctions.net/mcp

Authentication

Send your API key as the HTTP header Authorization: Bearer YOUR_API_KEY. The server does not use browser login sessions.

Client setup#

Create a key with the tools' required scopes, replace YOUR_API_KEY, and restart the client if it does not discover tools immediately.

Claude Code

claude mcp add --transport http humanpost https://us-central1-clickbaitcarousel.cloudfunctions.net/mcp --header "Authorization: Bearer YOUR_API_KEY"

Claude (web/desktop)

Add HumanPost as a custom connector in Claude.

1.Open Settings, then Connectors.
2.Choose Add custom connector and paste the MCP URL.
3.Set the Authorization header to Bearer followed by your API key.

URL: https://us-central1-clickbaitcarousel.cloudfunctions.net/mcp
Authorization: Bearer YOUR_API_KEY

Cursor

Add this server entry to your Cursor mcp.json file.

{
  "mcpServers": {
    "humanpost": {
      "url": "https://us-central1-clickbaitcarousel.cloudfunctions.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Any client

Use Streamable HTTP transport and send the API key on every request.

{
  "name": "humanpost",
  "transport": {
    "type": "streamable-http",
    "url": "https://us-central1-clickbaitcarousel.cloudfunctions.net/mcp"
  },
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

Tool catalog#

These focused publishing tools enforce the API key's scopes on every call. A client can discover a tool even when the current key cannot run it.

Tool	What it does	Required scope
list_accounts	List account IDs, readiness, daily usage, and queue state.	`accounts:read`
get_account_queue	Inspect the next queued posts for an account.	`posts:read`
create_account	Create an account in setup state with required warm-up search terms.	`accounts:write`
upload_media	Import media from a URL or begin a signed upload.	`posts:write`
complete_upload	Verify and process a completed signed upload.	`posts:write`
create_post	Create a video or carousel post and add it to queues.	`posts:write`
queue_post	Queue an existing draft post for one or more accounts.	`posts:write`
get_post_status	Read a post and its per-account publishing status.	`posts:read`
list_posts	List recent posts with account and status filters.	`posts:read`
update_post	Edit metadata while a post remains editable.	`posts:write`
cancel_post	Cancel pre-release items and report targets already posting, posted, or cancelled.	`posts:write`
get_post_analytics	Read the latest post metrics and analytics history.	`analytics:read`
get_usage	Read plan limits and today's API and post counts.	`usage:read`

create_post accepts 2–10 image upload IDs for a carousel; their upload order is the slide order.

Example workflow#

Connected to HumanPost MCP

You

Upload these 3 videos and spread them across my accounts over the next week. Use the launch caption and trending sound.

Agent

I'll check your ready accounts and queue capacity, upload each video, then create the scheduled posts.

Tools

list_accounts → upload_media × 3 → create_post × 3 → get_post_status × 3

Agent

Done. Three posts are queued across the selected accounts, spaced over seven days. I included each post ID for tracking.

Ask for the outcome, not the API calls. A capable agent can inspect your accounts, sequence the right tool calls, and return the IDs you need for follow-up.

Troubleshooting#

401 unauthorized

The key is missing, malformed, or revoked. Confirm the header starts with “Bearer ccb_live_” and rotate the key if its secret was lost.

insufficient_scope

The tool needs a permission the key does not have. Create a new key with the scope shown in the tools table, then update the client configuration.

Media errors

Use a public HTTPS source URL and a supported video or image. Wait for processing before creating a post, and keep carousels between 2 and 10 images.