Connect an AI agent (MCP)

Let Claude, ChatGPT, Cursor or any MCP client draft, schedule and publish for you.

Bulkit has an MCP server (Model Context Protocol). It lets AI agents use Bulkit with the same rules as the API: same permissions, same test mode, same plan limits.

The MCP address is your API address plus /mcp:

http://localhost:3001/public/v1/mcp

Connect

In the app, open Developers → MCP and pick the app you use. The page shows the exact steps for it.

The MCP page, with Claude, Claude Code, ChatGPT, Cursor and VS Code

There are two ways to connect:

Best for apps like Claude or ChatGPT.

  1. Paste the MCP address into your app as a new remote MCP server / connector.
  2. The app sends you to Bulkit. Pick a workspace and approve.
  3. Done — no key to copy.

You can disconnect the app at any time under Connected apps on the MCP page.

Best for tools that let you set a header, like Claude Code, Cursor or VS Code. Create an API key first.

Claude Code
claude mcp add --transport http bulkit http://localhost:3001/public/v1/mcp \
  --header "Authorization: Bearer bk_live_xxxxxxxxxxxxxxxx"

What the agent can do

The agent can only use these tools. Their inputs are the same as the API request bodies.

ToolDoes the same as
list_channelsGET /channels
list_platformsGET /platforms
list_tagsGET /tags
list_postsGET /posts
get_postGET /posts/{id}
get_post_metricsGET /posts/{id}/metrics
list_commentsGET /posts/{id}/comments
list_mediaGET /media
get_statsGET /stats
get_usageGET /usage
upload_media_from_urlPOST /media, from a public link
create_postPOST /posts
update_postPUT /posts/{id}
publish_postPOST /posts/{id}/publish
revise_postPOST /posts/{id}/revise
reply_to_commentPOST /posts/{id}/comments/{commentId}/replies, posts publicly
retract_postPOST /posts/{id}/retract — deletes live posts
delete_postDELETE /posts/{id}

The MCP page in the app always shows the current full list.

  • A read only key (or an app approved for read only) only gets the read tools.
  • Agents can add media from a public link (upload_media_from_url), but not a file on your computer. Upload those with POST /media or in the app first, then the agent can use them.
  • A good agent shows you each comment reply and asks before posting it. Each reply counts as one post. See Read and reply to comments.

On this page