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/mcpProtocol
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":{}}}'Tools that schedule, delete, approve, reject, publish, send, invite, or change billing require explicit user authorization. For MCP scheduling and deletion tools, pass confirm: true only after the user approves the action.
Private Codex connector
Start privately before any app-directory submission. Connect Codex with a scoped workspace key, prove read-only behavior, then test draft creation with a temporary full-access key.
- 1Create a read-only MCP key in Settings -> Developer.
- 2Store the key in a local environment variable instead of pasting it into prompts or config files.
- 3Add the AckPost MCP endpoint to Codex or your MCP client.
- 4Run initialize, tools/list, and read-only tool smoke tests before enabling write tools.
- 5Use a temporary full-access key only when you need to verify draft creation, then revoke it.
Codex MCP endpoint
https://ackpost.com/api/ackpost/mcpIf your MCP client supports HTTP headers, send Authorization: Bearer YOUR_ACKPOST_KEY. If it does not, use a local proxy that reads the key from an environment variable and injects the header.
Tool catalog
ackpost_list_brandsRead workspace brands available to the key.
ackpost_list_destinationsRead mapped publishing destinations and provider context.
ackpost_list_draftsRead draft content awaiting work or review.
ackpost_create_draftCreate a draft for review instead of publishing immediately.
ackpost_schedule_postSchedule approved content to a destination.
ackpost_list_articlesRead Article Studio items.
ackpost_create_articleCreate an article draft.
ackpost_update_articleUpdate article title, body, SEO, taxonomy, or status.
ackpost_schedule_articleSchedule an article through the owned-media lane.
ackpost_generate_social_blastCreate linked social drafts from a source article.
ackpost_generate_article_imageGenerate an article hero image where image generation is enabled.
ackpost_list_queueInspect queued and scheduled publishing work.
ackpost_list_approvalsInspect approval requests.
ackpost_approve_requestApprove content when the key has the right scope.
ackpost_reject_requestReject content with review context.
ackpost_list_proofsRead proof records attached to publishing events.
ackpost_list_inbox_threadsRead inbox context for response workflows.