HivePost API
Menu

Guides

MCP server

Let Claude and other AI apps plan, write and schedule posts in HivePost. You sign in with HivePost and choose what the app can do.

Server URL

https://hivepost.app/mcp

Streamable HTTP, sign-in with OAuth. It serves the 2026-07-28 revision and 2025 clients.

Add it in Claude

  1. Open Settings → Connectors → Add custom connector.
  2. Paste the server URL and choose Connect.
  3. Log in to HivePost, pick the workspace and the access, then Allow.

In Claude Code, run the command on the right, then /mcp to sign in.

Access

AccessCan
Drafts only (default)Read, save drafts and write captions. Nothing goes live without you.
Publish and readAlso schedule and publish. Needs two-factor sign-in.
Read onlyAccounts, posts, Best Time and analytics.

Owners and admins connect apps. See and disconnect them under Developers → Overview → MCP server; a disconnected app stops at once.

With an API key

Apps that send headers can use a key instead: Authorization: Bearer hp_test_…. A test key works in test mode: nothing reaches the Planner and captions are samples.

Tools

  • list_brandsread

    The brands in this HivePost workspace, with their time zones.

  • list_accountsread

    Connected social accounts. api says if the API can publish to the network now; drafts work on every network.

  • list_postsread

    Posts, newest first, with a Planner link. Use next_cursor for the next page.

  • get_postread

    One post with its status per account and a Planner link.

  • create_postdrafts or publish

    Saves a post for accounts of one brand. action "draft" (default) waits in the Planner; "schedule" (with publish_at) and "publish_now" need a connection that can publish.

  • delete_postdrafts or publish

    Moves a post to the Planner's Trash. Drafts-only connections delete drafts only.

  • get_best_timesread

    The brand's best time of day to post, from its own results once it has enough.

  • get_analyticsread

    Followers, totals and top posts for the last 7, 30 or 90 days (Free: 30), as on the Analytics screen.

  • write_captiondrafts or publish

    Hive AI in the brand voice, using AI credits like the Planner: "write" from photos (media_ids), "shorter", "versions" (one per network) or "first_comment" from text. If it answers status "writing", call again with caption_id.

Limits

  • Tool calls count toward the 60 a minute per connection and show in Developers → Logs as MCP.
  • write_caption uses AI credits, like the Planner.
  • Access tokens last an hour and refresh for 30 days.