Skip to content
CampaignStack CampaignStack

Quick Start

Connect to CampaignStack

Section titled “Connect to CampaignStack”

  1. Get an API key

    Go to Settings > Personal API keys and create a user key. Select the scopes you need (or “Select all” to start).

    Copy the key — it starts with csu_ and is shown only once. (Workspace-bound cs_ keys also exist — see Authentication.)

  2. Connect your MCP client

    Add to your Claude Desktop config (claude_desktop_config.json) or Claude Code settings:

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

  3. Verify the connection

    Call the campaignstack_whoami tool. It returns your available scopes and the workspaces you belong to:

    {
      "keyType": "user",
      "keyPrefix": "csu_a1b2",
      "scopes": ["campaigns:read", "campaigns:write", "leads:read"],
      "user": { "id": "...", "name": "...", "email": "..." },
      "workspaces": [
        { "workspaceId": "abc123", "name": "My Agency", "role": "owner" }
      ]
    }

  4. Make your first real call

    Ask your agent to list your campaigns. It calls campaignstack_get_campaigns with the workspaceId from whoami:

    {
      "filters": { "workspaceId": "abc123" },
      "include": { "icp": {} }
    }

    Most get_* tools share this shape: ids to fetch specific records, filters to list, and include to pull related data in the same call. Pass a returned campaign ID as filters.campaignId to campaignstack_get_workflows to see its workflows.

What’s next

Section titled “What’s next”
  • Concepts — Understand campaigns, leads, workflows, ICPs
  • Authentication — API key format, scopes, security
  • Tool Reference — Full reference for every tool, generated from the server