Quick Start

Connect to CampaignStack

1. Get an API key

   Go to your workspace Settings > API Keys and create a new key. Select the scopes you need (or “Select all” to start).

   Copy the key — it starts with cs_ and is shown only once.

2. Connect your MCP client

   Claude Desktop

   Add to your Claude Desktop config (~/.claude/settings.json or Claude Desktop settings):

   {
     "mcpServers": {
       "campaignstack": {
         "url": "https://mcp.campaignstack.io/mcp",
         "headers": {
           "Authorization": "Bearer cs_your_api_key_here"
         }
       }
     }
   }

   Cursor

   In Cursor settings, add an MCP server:

   • Name: campaignstack
   • URL: https://mcp.campaignstack.io/mcp
   • Headers: Authorization: Bearer cs_your_api_key_here
   curl

   Test the connection directly:

   curl -X POST https://mcp.campaignstack.io/mcp \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer cs_your_api_key_here" \
     -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/list"
     }'

3. Verify the connection

   Call the campaignstack_whoami tool. It returns your workspace name, available scopes, and key prefix:

   {
     "workspaceId": "abc123",
     "workspaceName": "My Agency",
     "scopes": ["campaigns:read", "campaigns:write", "leads:read"],
     "keyPrefix": "cs_a1b2c3"
   }

4. Make your first real call

   Try listing your campaigns:

   Use the campaignstack_list_campaigns tool with workspaceId from whoami

   The response includes campaign IDs you can use with campaignstack_get_campaign, campaignstack_list_workflows, and other tools.

What’s next

• Concepts — Understand campaigns, leads, workflows, ICPs
• Authentication — API key format, scopes, security
• Tool Reference — Full reference for all 63 tools