Public MCP docs

Agent workflows that still respect approvals.

AckPost exposes publishing workflows through MCP so agents can prepare drafts, inspect context, schedule approved work, and generate article-linked social campaigns without bypassing team controls.

Endpoint

https://ackpost.com/api/ackpost/mcp

Protocol

JSON-RPC over HTTP

Supports initialize, tools/list, tools/call, and ping.

Authentication

Bearer MCP key

Create workspace keys after sign-in. Docs stay public.

Quick start

Replace YOUR_ACKPOST_KEY with a workspace MCP key from the signed-in developer settings page.

curl -X POST "https://ackpost.com/api/ackpost/mcp" \
  -H "Authorization: Bearer YOUR_ACKPOST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}'

curl -X POST "https://ackpost.com/api/ackpost/mcp" \
  -H "Authorization: Bearer YOUR_ACKPOST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"2","method":"tools/call","params":{"name":"ackpost_list_queue","arguments":{}}}'

Tool catalog

ackpost_list_brands

Read workspace brands available to the key.

ackpost_list_destinations

Read mapped publishing destinations and provider context.

ackpost_list_drafts

Read draft content awaiting work or review.

ackpost_create_draft

Create a draft for review instead of publishing immediately.

ackpost_schedule_post

Schedule approved content to a destination.

ackpost_list_articles

Read Article Studio items.

ackpost_create_article

Create an article draft.

ackpost_update_article

Update article title, body, SEO, taxonomy, or status.

ackpost_schedule_article

Schedule an article through the owned-media lane.

ackpost_generate_social_blast

Create linked social drafts from a source article.

ackpost_generate_article_image

Generate an article hero image where image generation is enabled.

ackpost_list_queue

Inspect queued and scheduled publishing work.

ackpost_list_approvals

Inspect approval requests.

ackpost_approve_request

Approve content when the key has the right scope.

ackpost_reject_request

Reject content with review context.

ackpost_list_proofs

Read proof records attached to publishing events.

ackpost_list_inbox_threads

Read inbox context for response workflows.

Developer docs