OPEN SOURCE · AGPL-3.0

Built for developers.
API-first from day one.

Schedule social media posts programmatically via REST API, connect your AI agent via MCP, or self-host the entire stack. Full source code, no black boxes.

Read the docsView on GitHub
Multiple
platforms
10
MCP tools
AGPLv3
license
0
vendor lock-in

REST API

Schedule posts programmatically

The Posthive REST API lets you create, list, update, and delete scheduled posts from any language or tool. Authenticate with an API key prefixed ph_and you're posting.

GET /api/v1/accountsList connected social accounts
POST /api/v1/postsCreate a scheduled post
PATCH /api/v1/posts/:idUpdate a scheduled post
POST /api/v1/posts/:id/duplicateDuplicate a post
GET /api/v1/templatesList post templates
POST /api/v1/uploadUpload media for a post
create-post.sh
curl -X POST https://posthive.co/api/v1/posts \
  -H "Authorization: Bearer ph_yourkey" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Shipped v2.0 today 🚀",
    "accountIds": ["acc_bluesky", "acc_threads"],
    "scheduledFor": "2026-07-08T09:00:00Z"
  }'

MCP Integration

mcp.json
// .claude/mcp.json
{
  "mcpServers": {
    "posthive": {
      "type": "http",
      "url": "https://posthive.co/mcp/ph_yourkey"
    }
  }
}

// Claude Code now has access to:
// list_accounts · create_post · list_scheduled_posts
// approve_draft · update_post · delete_post · and more

Let your AI agent post for you

Posthive ships with a full MCP server. Drop your API key into your Claude Code or Cursor config and your AI agent can list accounts, create posts, approve drafts, and manage your queue — all via natural language.

MCP access requires a Pro or Team plan.
list_accounts — see all connected social accounts
create_post — schedule content across platforms
approve_draft — promote a draft to scheduled
update_post — edit content or reschedule
list_templates — browse saved post templates
delete_post — remove from the queue

Self-hosting

Your server. Your data. Your rules.

Posthive is fully self-hostable under AGPL-3.0. OAuth credentials are AES-256-GCM encrypted at rest and never leave your infrastructure. Set ENABLE_BILLING=false to unlock every feature for all users — no trial, no limits.

SQLite or Postgres
Redis / Upstash
Railway · Fly.io · Render
AES-256-GCM encryption
Terminal
$ git clone https://github.com/posthive/posthive
$ cd posthive && cp apps/api/.env.example apps/api/.env

# Fill in your secrets, then:
$ pnpm install
$ cd apps/api && pnpm db:migrate
$ pnpm dev

# API → http://localhost:3001
# Web → http://localhost:3000

Why open source

Audit the code

Every line that touches your OAuth tokens is public. Read it, fork it, run a security audit — the code is yours to inspect.

No surprise pricing

AGPL-3.0 means the scheduling engine can never be locked behind a paywall. Self-hosted deployments are permanently free.

Extend it freely

Add a new platform, build internal tooling, wire it into your existing stack. Modify and deploy without asking permission.

Frequently asked questions

What is the Posthive REST API?

Posthive exposes a public REST API at /api/v1 that lets you create posts, manage accounts, upload media, and work with templates programmatically using an API key.

What is MCP and how does Posthive use it?

MCP (Model Context Protocol) is a standard for connecting AI agents to external tools. Posthive has a built-in MCP server that lets AI agents like Claude Code or Cursor create and schedule posts via tool calls.

Can I self-host Posthive on my own server?

Yes. Posthive is fully self-hostable under AGPL-3.0. Clone the repo, configure your .env, run database migrations, and deploy to Railway, Fly.io, Render, or any VPS.

How do I get an API key?

API keys are available on the Pro and Team plans. Generate one from your account settings page. Keys are prefixed with ph_ and can be scoped and revoked at any time.

Start building with Posthive

14-day free trial on hosted. Or self-host for free today — the repo is public and the docs will get you running in under 10 minutes.

Read the docsStart free trial