Kochava for Advertisers

Kochava for Advertisers — MCP Server


Kochava for Advertisers is the Omnichannel measurement and attribution platform provided by Kochava, incorporating last-click attribution, incrementality, and MMM tools for brands and their agencies.

This MCP server lets any AI tool query live Kochava attribution data, manage campaigns, and create reports — with no existing account required. Connect, create a free account in-session, and start querying immediately.

No Account? No Problem.

You don't need a Kochava account to get started. The server includes two public tools that work without any authentication:

1. kochava_free_app_analytics_get_tos — Review the Free App Analytics Terms of Service
2. kochava_free_app_analytics_create_acc_and_get_auth_key — Create a free account and receive your API key instantly, right in the conversation

Once you have your API key, set it as the authentication-key header and the full suite of 30 tools becomes available.

Connect

Endpoint: https://analytics.mcp.kochava.com/mcp Transport: Streamable HTTP Authentication: authentication-key header (optional for signup, required for data tools)

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or ~/.config/claude/claude_desktop_config.json (Linux), or via Settings → Developer → Edit Config in the app:

{
  "mcpServers": {
    "kochava": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://analytics.mcp.kochava.com/mcp",
        "--header", "authentication-key:YOUR_API_KEY"
      ]
    }
  }
}

Requires Node.js (for npx). Leave authentication-key empty or omit the --header argument entirely to start with FAA signup tools only. Fully quit and reopen Claude Desktop after saving for the change to take effect.

Claude Code

claude mcp add kochava --transport streamable-http https://analytics.mcp.kochava.com/mcp --header "authentication-key: YOUR_API_KEY"

Omit the --header argument entirely to start with FAA signup tools only.

Cursor

Settings → Tools & MCPs → Add Custom MCP, which opens ~/.cursor/mcp.json (or .cursor/mcp.json in a project) for editing:

{
  "mcpServers": {
    "kochava": {
      "url": "https://analytics.mcp.kochava.com/mcp",
      "headers": {
        "authentication-key": "YOUR_API_KEY"
      }
    }
  }
}

Leave authentication-key empty or omit the headers block entirely to start with FAA signup tools only.

VS Code / GitHub Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "kochava": {
      "type": "streamable-http",
      "url": "https://analytics.mcp.kochava.com/mcp",
      "headers": {
        "authentication-key": "YOUR_API_KEY"
      }
    }
  }
}

Tools

Free App Analytics (no auth required)

| Tool | Description | |------|-------------| | kochava_free_app_analytics_get_tos | Get the FAA Terms of Service link | | kochava_free_app_analytics_create_acc_and_get_auth_key | Create a free account and get an API key in-session |

Analytics & Reporting

| Tool | Description | |------|-------------| | get_all_apps | List all apps in your account | | get_app_dimensions | Get dimensions available for an app | | run_search_query | Run an analytics search query | | get_event_detail | Get event-level detail data | | get_explorer_data | Query the analytics explorer | | get_funnel_data | Get funnel analysis data | | get_LTV_details | Get lifetime value details | | get_retention_overlay | Get retention overlay data | | get_currencies | List supported currencies |

Report Querying

| Tool | Description | |------|-------------| | search_tables | Search available report tables | | get_saved_queries | List saved report queries | | execute_report_query | Execute a report query | | get_query_results | Get results from an executed query |

Campaign Management

| Tool | Description | |------|-------------| | kochava_list_campaigns | List all campaigns | | kochava_get_campaign | Get campaign details | | kochava_create_campaign | Create a new campaign | | kochava_update_campaign | Update an existing campaign |

Tracker Management

| Tool | Description | |------|-------------| | kochava_list_trackers | List all trackers | | kochava_create_tracker | Create a new tracker | | kochava_update_tracker | Update an existing tracker | | kochava_delete_tracker | Delete a tracker | | kochava_get_tracker_metrics | Get tracker performance metrics | | kochava_get_all_media_partners | List available media partners | | kochava_get_agency_networks | List agency networks | | kochava_list_events_for_tracker_creation | List events available for tracker setup |

Segment Management

| Tool | Description | |------|-------------| | kochava_list_segments | List all segments | | kochava_create_segment | Create a new segment | | kochava_update_segment | Update an existing segment |

Authentication

Without a key: You can connect and use the two FAA signup tools to create a free account. Your API key is returned immediately in the conversation.

With a key: Set the authentication-key header to your Kochava API key. All 30 tools become available.

Free App Analytics gives you 30 days of data retention. Upgrade to Enterprise for unlimited retention — same API key, same MCP connection, zero migration.

Troubleshooting

| Error | Cause | Fix | |-------|-------|-----| | 401 Unauthorized | Missing authentication-key header | Add your API key as the authentication-key header | | 403 Invalid token | API key not recognized | Verify your key at console.kochava.com | | 503 Service unavailable | Auth service temporarily down | Retry in a few seconds | | account_exists | Company name already registered | Use a different company name or log in at console.kochava.com |

Support

• Email: support@freeappanalytics.com
• Console: console.kochava.com

<!-- smithery-verification=96309c88075d1d87e141dfb766db8b75e736ac13f39824dc7a00a03eb4dadc6b -->