MCP Tools Reference - Autoposting

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`

{
  "name": "create-post",
  "arguments": {
    "brandSlug": "my-brand",
    "text": "Hello from MCP!",
    "platforms": ["x", "linkedin"]
  }
}

update-post — Update draft content

Param	Type	Required
`postId`	string	Yes
`text`	string	No

{ "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 (5 tools)

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

Standard CRUD + render. Key params: clipId, url (for import).

{ "name": "import-clip", "arguments": { "url": "https://youtube.com/watch?v=..." } }
{ "name": "render-clip", "arguments": { "clipId": "clip_abc" } }

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.

​Transport

​Posts (10 tools)

​Brands (6 tools)

​Agents (8 tools)

​Knowledge Base (7 tools)

​Ideas (4 tools)

​Clips (5 tools)

​Carousels (6 tools)

​Webhooks (6 tools)

​Billing & Usage (3 tools)

​Error Reference

MCP Setup

MCP Overview

CLI Commands

TypeScript SDK

Transport

Posts (10 tools)

Brands (6 tools)

Agents (8 tools)

Knowledge Base (7 tools)

Ideas (4 tools)

Clips (5 tools)

Carousels (6 tools)

Webhooks (6 tools)

Billing & Usage (3 tools)

Error Reference