MCP Quick Start

Connect your IDE, agent framework, or custom runtime to ASAPilot in under 5 minutes using the Model Context Protocol.

What is MCP?

Model Context Protocol is an open standard that lets AI assistants access external tools and data sources. ASAPilot exposes its chat, account lookup, and automation management capabilities as an MCP server so you can integrate Apple Search Ads workflows into any MCP-compatible environment.

Step 1: Provision an MCP channel

1. Log in to app.asapilot.com and navigate to Channels.
2. Click Provision on the MCP card.
3. Copy the generated MCP server URL and API key. You'll need both for the next step.

Step 2: Configure your MCP client

Add the ASAPilot MCP server to your client configuration. The exact format depends on your client, but here's a typical example for Claude Desktop or similar MCP clients:

{
  "mcpServers": {
    "asapilot": {
      "url": "https://api.asapilot.com/mcp/YOUR_WORKSPACE_ID",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Step 3: Initialize and list tools

Once configured, your MCP client will automatically call initialize and tools/list to discover available ASAPilot tools. You should see 5 tools: chat.send, accounts.list, automations.list, automations.create, and automations.run.

Step 4: Make your first tool call

Try listing your connected accounts:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts.list",
    "arguments": {}
  }
}

Or send a chat message:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "chat.send",
    "arguments": {
      "message": "Show me my top spending campaigns this week",
      "thread_id": "my-first-thread"
    }
  }
}

What's next?