Agent Kong MCP Server

Give Claude (or any MCP client) full access to your Agent Kong business data — attribution, financials, conversations, and CRM.

Quick Setup

1. Build the server

cd mcp-server
npm install
npx tsc

2. Add to Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "agentkong": {
      "command": "node",
      "args": ["/FULL/PATH/TO/mcp-server/dist/index.js"],
      "env": {
        "AGENTKONG_API_KEY": "sk-ak-your-api-key-here",
        "AGENTKONG_BUSINESS_ID": "your-business-id-here",
        "AGENTKONG_API_URL": "https://app.agentkong.com"
      }
    }
  }
}

Replace:

• /FULL/PATH/TO/ with the actual path to this folder
• sk-ak-your-api-key-here with your API key (needs all scopes)
• your-business-id-here with your business UUID
• URL with http://localhost:3000 for local dev

3. Restart Claude Desktop

You should see a hammer icon in the chat input — that means your tools are loaded.

Available Tools

| Tool | What it does | Example question | |---|---|---| | get_attribution | Full attribution table with drill-down | "Which ad has the best ROAS?" | | get_utms | Available UTM values for filtering | "What sources do I have?" | | get_presets | Attribution column presets | "What presets are available?" | | get_stripe_financials | Stripe payments, subs, metrics, customers | "What's my MRR?" | | get_shopify_data | Shopify orders, customers, products, analytics | "What's my top product?" | | get_whop_data | Whop payments, customers, memberships | "Show me Whop revenue" | | get_conversations | Conversation history and messages | "What are customers asking about?" | | get_call_data | Voice call logs and transcripts | "Summarize recent sales calls" | | get_contacts | CRM contacts and customer journey | "Show me this customer's journey" | | get_conversion_events | Conversion entries and LTV analysis | "Who are my highest LTV customers?" |

Example Conversations

Revenue analysis:

"What's my total revenue this month across Stripe, Shopify, and Whop?"

Ad performance:

"Show me my top 5 ad campaigns by ROAS for the last 30 days"

Churn investigation:

"Which customers churned last week? Check their recent conversations to understand why"

Customer journey:

"Show me the full journey for customer [email protected] — from first visit to purchase"

API Key Scopes

Your API key needs these scopes for full access:

• contacts:read, conversations:read, messages:read
• agents:read, appointments:read
• conversions:read, tracking:read
• tags:read, custom_fields:read
• attribution:read, stripe:read, shopify:read, whop:read

Create a key with all scopes from: Settings → API Keys → Generate New Key