Every guide elsewhere in these docs assumes you're clicking through the PromotiAI dashboard by hand. This guide is different: it's for running PromotiAI from an AI agent — Claude, or any other client that speaks the Model Context Protocol (MCP) — instead of the UI.
PromotiAI exposes a hosted MCP server at https://promotiai.com/api/mcp. Once your agent is connected, it can list workspaces and projects, draft and edit posts, generate AI copy and media, schedule publishes, queue agent automation events, and pull attribution data — all as tool calls, with no browser involved.
On top of the raw tools, you can write a skill — a persona/workflow file your agent loads before it starts working — so it already knows your agency's brand voice, ICP, platform cadence, and the exact tool sequence to run. This guide covers both: connecting your client to the MCP server, and building your own skill on top of it.
Ready to connect an agent?
Create an MCP API key in Dashboard → Settings and point your client at https://promotiai.com/api/mcp.
Treat MCP keys like passwords
Grant only the scopes a given client needs, set an expiry, and revoke a key immediately if it's exposed. Keys are shown once at creation and never displayed again.