DocsSkills & MCPIntroduction

Skills & MCP: Automate PromotiAI with AI Agents

10 min read·1 / 13

What is Skills & MCP access?

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.