MCP Tools Reference

Input schemas and examples for all 56 Autoposting MCP tools.

Transport

The CLI MCP server uses stdio transport — JSON-RPC messages over stdin/stdout:

AI Agent <--stdin/stdout--> ap mcp (Node.js) <--HTTP--> Autoposting API

All tool calls use standard MCP tools/call format.

---

Posts (10 tools)

list-posts — List posts with filters

Param	Type	Required
brandSlug	string	No
status	string	No — draft, scheduled, published, failed

{ "name": "list-posts", "arguments": { "brandSlug": "my-brand", "status": "draft" } }

get-post — Get post by ID

Param	Type	Required
postId	string	Yes

{ "name": "get-post", "arguments": { "postId": "post_abc" } }

create-post — Create a draft post

Param	Type	Required
brandSlug	string	Yes
text	string	Yes
platforms	string[]	No — x, linkedin, instagram, threads, youtube
media	object[]	No — up to 10 { url, type, altText? } items; type is image, video, or gif

{
  "name": "create-post",
  "arguments": {
    "brandSlug": "my-brand",
    "text": "Hello from MCP!",
    "platforms": ["x", "linkedin"],
    "media": [{ "url": "https://example.com/hero.png", "type": "image", "altText": "Product hero" }]
  }
}

Media must be a public https URL. An MCP tool call cannot carry file bytes, so an assistant cannot upload a file from your computer. Upload local files in the app or with ap posts create --media <file>, or share a public link.

update-post — Update draft content

Param	Type	Required
postId	string	Yes
text	string	No
media	object[]	No — replaces the post’s media; same item shape as create-post

{ "name": "update-post", "arguments": { "postId": "post_abc", "text": "Updated text" } }

delete-post — Delete post permanently

Param	Type	Required
postId	string	Yes

{ "name": "delete-post", "arguments": { "postId": "post_abc" } }

publish-post — Publish immediately

Param	Type	Required
postId	string	Yes

{ "name": "publish-post", "arguments": { "postId": "post_abc" } }

schedule-post — Schedule future publish

Param	Type	Required
postId	string	Yes
scheduledAt	string	Yes — ISO 8601

{ "name": "schedule-post", "arguments": { "postId": "post_abc", "scheduledAt": "2026-06-20T10:00:00Z" } }

retry-post — Retry failed publish

Param	Type	Required
postId	string	Yes

{ "name": "retry-post", "arguments": { "postId": "post_abc" } }

rewrite-post — AI-rewrite for engagement

Param	Type	Required
postId	string	Yes

{ "name": "rewrite-post", "arguments": { "postId": "post_abc" } }

score-post — AI scoring with feedback

Param	Type	Required
postId	string	Yes

{ "name": "score-post", "arguments": { "postId": "post_abc" } }

---

Brands (6 tools)

list-brands — List all brands

No parameters required.

{ "name": "list-brands", "arguments": {} }

get-brand — Get brand details

Param	Type	Required
brandSlug	string	Yes

{ "name": "get-brand", "arguments": { "brandSlug": "my-brand" } }

create-brand — Create a brand

Param	Type	Required
name	string	Yes
timezone	string	No — IANA timezone

{ "name": "create-brand", "arguments": { "name": "My Brand", "timezone": "America/New_York" } }

update-brand — Update brand settings

Param	Type	Required
brandSlug	string	Yes
name	string	No

{ "name": "update-brand", "arguments": { "brandSlug": "my-brand", "name": "New Name" } }

delete-brand — Delete a brand

Param	Type	Required
brandSlug	string	Yes

{ "name": "delete-brand", "arguments": { "brandSlug": "my-brand" } }

Deletes the brand and disconnects all social accounts. Cannot be undone.

brand-auth-status — Platform connection status

Param	Type	Required
brandSlug	string	Yes

{ "name": "brand-auth-status", "arguments": { "brandSlug": "my-brand" } }

Returns connection status for X, LinkedIn, Instagram, Threads, YouTube.

---

Agents (8 tools)

list-agents — List all AI agents

{ "name": "list-agents", "arguments": {} }

get-agent — Get agent details

Param	Type	Required
agentId	string	Yes

{ "name": "get-agent", "arguments": { "agentId": "agent_abc" } }

create-agent — Create an AI agent

Param	Type	Required
name	string	Yes
brandSlug	string	Yes
type	string	No — publish
frequency	string	No — daily, weekly

{ "name": "create-agent", "arguments": { "name": "Daily News", "brandSlug": "my-brand" } }

update-agent — Update agent config

Param	Type	Required
agentId	string	Yes

{ "name": "update-agent", "arguments": { "agentId": "agent_abc", "name": "Weekly Digest" } }

delete-agent — Delete an agent

Param	Type	Required
agentId	string	Yes

{ "name": "delete-agent", "arguments": { "agentId": "agent_abc" } }

run-agent — Trigger immediate run

Param	Type	Required
agentId	string	Yes

{ "name": "run-agent", "arguments": { "agentId": "agent_abc" } }

toggle-agent — Enable or disable

Param	Type	Required
agentId	string	Yes

{ "name": "toggle-agent", "arguments": { "agentId": "agent_abc" } }

agent-runs — View run history

Param	Type	Required
agentId	string	Yes

{ "name": "agent-runs", "arguments": { "agentId": "agent_abc" } }

---

Knowledge Base (7 tools)

list-kbs — List all knowledge bases

{ "name": "list-kbs", "arguments": {} }

get-kb — Get KB details

Param	Type	Required
kbId	string	Yes

{ "name": "get-kb", "arguments": { "kbId": "kb_abc" } }

create-kb — Create a knowledge base

Param	Type	Required
name	string	Yes

{ "name": "create-kb", "arguments": { "name": "Product Docs" } }

delete-kb — Delete a knowledge base

Param	Type	Required
kbId	string	Yes

{ "name": "delete-kb", "arguments": { "kbId": "kb_abc" } }

search-kb — Semantic search

Param	Type	Required
kbId	string	Yes
query	string	Yes

{ "name": "search-kb", "arguments": { "kbId": "kb_abc", "query": "pricing strategy" } }

ingest-kb — Ingest URL into KB

Param	Type	Required
kbId	string	Yes
url	string	Yes

{ "name": "ingest-kb", "arguments": { "kbId": "kb_abc", "url": "https://docs.example.com" } }

kb-docs — List KB documents

Param	Type	Required
kbId	string	Yes

{ "name": "kb-docs", "arguments": { "kbId": "kb_abc" } }

---

Ideas (4 tools)

list-ideas — List content ideas

{ "name": "list-ideas", "arguments": {} }

generate-ideas — AI-generate from topic

Param	Type	Required
topic	string	Yes
count	number	No — default 5

{ "name": "generate-ideas", "arguments": { "topic": "AI trends", "count": 10 } }

enrich-idea — Add AI context

Param	Type	Required
ideaId	string	Yes

{ "name": "enrich-idea", "arguments": { "ideaId": "idea_abc" } }

delete-idea — Delete an idea

Param	Type	Required
ideaId	string	Yes

{ "name": "delete-idea", "arguments": { "ideaId": "idea_abc" } }

---

Clips (6 tools)

list-clips / get-clip / import-clip / render-clip / create-clip-draft / delete-clip

Tool	Required	Optional
import-clip	url, brandId (the id from list-brands)	name
get-clip	id	—
render-clip	id, editRevision (from get-clip)	candidateId
create-clip-draft	id	candidateId, aspectRatio (9:16, 16:9, 1:1, 4:5)
delete-clip	id	—
list-clips	—	—

AI clipping flow: import-clip → poll get-clip until status is ready → render-clip → poll get-clip until the candidate’s renderStatus is completed → create-clip-draft → publish-post or schedule-post.

{ "name": "import-clip", "arguments": { "url": "https://youtube.com/watch?v=...", "brandId": "665f1c2a9b1e8a0012345678" } }
{ "name": "render-clip", "arguments": { "id": "clip_abc", "editRevision": 3 } }
{ "name": "create-clip-draft", "arguments": { "id": "clip_abc", "aspectRatio": "9:16" } }

Carousels (6 tools)

list-carousels / get-carousel / create-carousel / generate-carousel / draft-carousel / delete-carousel

Standard CRUD + AI generation + draft conversion. Key params: carouselId, brandSlug, topic, slideCount.

{ "name": "generate-carousel", "arguments": { "topic": "5 Growth Tips", "brandSlug": "my-brand", "slideCount": 5 } }
{ "name": "draft-carousel", "arguments": { "carouselId": "carousel_abc" } }

Webhooks (6 tools)

list-webhooks / get-webhook / create-webhook / update-webhook / delete-webhook / test-webhook

Standard CRUD + test. Key params: webhookId, url, events.

{ "name": "create-webhook", "arguments": { "url": "https://api.example.com/hook", "events": ["post.published", "post.failed"] } }
{ "name": "test-webhook", "arguments": { "webhookId": "wh_abc" } }

Billing & Usage (3 tools)

billing-status / billing-credits / usage-summary

No parameters required for any of these.

{ "name": "billing-status", "arguments": {} }
{ "name": "billing-credits", "arguments": {} }
{ "name": "usage-summary", "arguments": {} }

---

Error Reference

Scenario	isError	Message
Invalid API key	true	Authentication error
Insufficient scope	true	Scope error — missing required permission
Resource not found	true	Not found
Invalid input	true	Validation error with field details
Rate limited	true	Rate limit exceeded
Server error	true	Internal server error

MCP Setup

Connect in under 2 minutes.

MCP Overview

Architecture and tool summary.

CLI Commands

Same operations via terminal.

TypeScript SDK

Build integrations programmatically.