Quickstart

You need a Warmup account. If you don’t have one yet, sign up — it takes a minute.

Option A: connect an AI agent

1. Add the Warmup MCP server to your client. The server URL is:

   https://mcp.warmup.social/mcp

   Claude Code

   claude mcp add --transport http warmup https://mcp.warmup.social/mcp

   Claude.ai / Desktop

   Settings → Connectors → Add custom connector, paste the URL above.

   ChatGPT

   Settings → Connectors (developer mode) → create a connector with the URL above.

   Cursor

   Add to ~/.cursor/mcp.json:

   {
     "mcpServers": {
       "warmup": { "url": "https://mcp.warmup.social/mcp" }
     }
   }

2. The client opens a browser window. Sign in to Warmup and click Allow.

3. Ask the agent something:

   Show my projects and which networks are connected.

   How did my Instagram do over the last 30 days? What were the top posts?

More clients and details: Connect a client.

Option B: call the REST API

1. Create an API token in the dashboard: API tokens → Create token. Copy the wmp_… value — it is shown only once.

2. List your projects:

   curl https://api.warmup.social/projects \
     -H "Authorization: Bearer wmp_YOUR_TOKEN"

3. Get an analytics overview for the last 30 days:

   curl "https://api.warmup.social/analytics/overview?role=own" \
     -H "Authorization: Bearer wmp_YOUR_TOKEN"

Next: authentication, the publishing guide and the API reference.