Developers
Designed, on-brand posts for your AI agents and workflows
One POST returns a finished, branded board post: composed from your account's authored content banks and rendered through the same brand template pipeline your weekly plans use. Wire it into n8n, Zapier, or an AI agent over MCP. Nothing is ever published on your behalf - publishing stays behind the in-app approval gate.
Quickstart
Authenticate with your API key (Authorization: Bearer sk_...) and generate a post. Both fields are optional: leave kind out to rotate through the kinds your brand has material for, or pass one of tip | quote | poll | product | offer.
curl -X POST https://api.stratvo.com/api/public/v1/posts/generate \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"kind": "tip",
"topic": "lighting"
}'The call is synchronous and typically takes a few seconds. A 201 returns the finished post, including a stable image_url for the rendered board:
{
"id": "0b0e...-uuid",
"kind": "tip",
"status": "completed",
"title": "Sunday batching",
"caption": "Batch your posts on Sunday evening. Save this",
"image_url": "https://api.stratvo.com/api/v1/media/img/...",
"design_variant": "ink"
}Fetch a post again later with GET /api/public/v1/posts/{id} (same auth, scoped to your account).
MCP server for agents
A standalone stdio MCP server (Node 18+) exposes two tools, generate_post and get_post, that call the endpoints above with the key from STRATVO_API_KEY.
cd mcp-server && npm install
STRATVO_API_KEY=sk_... node index.js # STRATVO_API_URL overrides the originClaude Desktop / Claude Code configuration:
{
"mcpServers": {
"stratvo": {
"command": "node",
"args": ["/path/to/mcp-server/index.js"],
"env": { "STRATVO_API_KEY": "sk_..." }
}
}
}Scopes and limits
- Keys must carry the
posts:generatescope. - 30 generations per minute per key.
- Errors are always structured, never a raw 500 - for example
422 NO_MATERIALwhen there is no bank or catalogue material for the requested kind, and429 RATE_LIMITEDover the limit. - No publishing: the API never schedules or posts to your social accounts.
Get a key
Public API keys are issued on request while the API is in v1 - we set one up for your account and send you the key (it is shown exactly once, so store it safely). Tell us what you are building and we will get you set up.