{
  "markdown": "# Kochava for Advertisers — MCP Server\n\n[![MCP Badge](https://lobehub.com/badge/mcp/kochava-kochava-k4a-mcp-server)](https://lobehub.com/mcp/kochava-kochava-k4a-mcp-server)\n\nKochava 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.\n\nThis 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.\n\n## No Account? No Problem.\n\nYou don't need a Kochava account to get started. The server includes two **public tools** that work without any authentication:\n\n1. **`kochava_free_app_analytics_get_tos`** — Review the Free App Analytics Terms of Service\n2. **`kochava_free_app_analytics_create_acc_and_get_auth_key`** — Create a free account and receive your API key instantly, right in the conversation\n\nOnce you have your API key, set it as the `authentication-key` header and the full suite of 30 tools becomes available.\n\n## Connect\n\n**Endpoint**: `https://analytics.mcp.kochava.com/mcp`\n**Transport**: Streamable HTTP\n**Authentication**: `authentication-key` header (optional for signup, required for data tools)\n\n### Claude Desktop\n\nAdd 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:\n\n```json\n{\n  \"mcpServers\": {\n    \"kochava\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\", \"mcp-remote\",\n        \"https://analytics.mcp.kochava.com/mcp\",\n        \"--header\", \"authentication-key:YOUR_API_KEY\"\n      ]\n    }\n  }\n}\n```\n\nRequires 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.\n\n### Claude Code\n\n```bash\nclaude mcp add kochava --transport streamable-http https://analytics.mcp.kochava.com/mcp --header \"authentication-key: YOUR_API_KEY\"\n```\n\nOmit the `--header` argument entirely to start with FAA signup tools only.\n\n### Cursor\n\nSettings → Tools & MCPs → Add Custom MCP, which opens `~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project) for editing:\n\n```json\n{\n  \"mcpServers\": {\n    \"kochava\": {\n      \"url\": \"https://analytics.mcp.kochava.com/mcp\",\n      \"headers\": {\n        \"authentication-key\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nLeave `authentication-key` empty or omit the `headers` block entirely to start with FAA signup tools only.\n\n### VS Code / GitHub Copilot\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"kochava\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://analytics.mcp.kochava.com/mcp\",\n      \"headers\": {\n        \"authentication-key\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### Free App Analytics (no auth required)\n\n| Tool | Description |\n|------|-------------|\n| `kochava_free_app_analytics_get_tos` | Get the FAA Terms of Service link |\n| `kochava_free_app_analytics_create_acc_and_get_auth_key` | Create a free account and get an API key in-session |\n\n### Analytics & Reporting\n\n| Tool | Description |\n|------|-------------|\n| `get_all_apps` | List all apps in your account |\n| `get_app_dimensions` | Get dimensions available for an app |\n| `run_search_query` | Run an analytics search query |\n| `get_event_detail` | Get event-level detail data |\n| `get_explorer_data` | Query the analytics explorer |\n| `get_funnel_data` | Get funnel analysis data |\n| `get_LTV_details` | Get lifetime value details |\n| `get_retention_overlay` | Get retention overlay data |\n| `get_currencies` | List supported currencies |\n\n### Report Querying\n\n| Tool | Description |\n|------|-------------|\n| `search_tables` | Search available report tables |\n| `get_saved_queries` | List saved report queries |\n| `execute_report_query` | Execute a report query |\n| `get_query_results` | Get results from an executed query |\n\n### Campaign Management\n\n| Tool | Description |\n|------|-------------|\n| `kochava_list_campaigns` | List all campaigns |\n| `kochava_get_campaign` | Get campaign details |\n| `kochava_create_campaign` | Create a new campaign |\n| `kochava_update_campaign` | Update an existing campaign |\n\n### Tracker Management\n\n| Tool | Description |\n|------|-------------|\n| `kochava_list_trackers` | List all trackers |\n| `kochava_create_tracker` | Create a new tracker |\n| `kochava_update_tracker` | Update an existing tracker |\n| `kochava_delete_tracker` | Delete a tracker |\n| `kochava_get_tracker_metrics` | Get tracker performance metrics |\n| `kochava_get_all_media_partners` | List available media partners |\n| `kochava_get_agency_networks` | List agency networks |\n| `kochava_list_events_for_tracker_creation` | List events available for tracker setup |\n\n### Segment Management\n\n| Tool | Description |\n|------|-------------|\n| `kochava_list_segments` | List all segments |\n| `kochava_create_segment` | Create a new segment |\n| `kochava_update_segment` | Update an existing segment |\n\n## Authentication\n\n**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.\n\n**With a key**: Set the `authentication-key` header to your Kochava API key. All 30 tools become available.\n\n**Free App Analytics** gives you 30 days of data retention. Upgrade to Enterprise for unlimited retention — same API key, same MCP connection, zero migration.\n\n## Troubleshooting\n\n| Error | Cause | Fix |\n|-------|-------|-----|\n| 401 Unauthorized | Missing `authentication-key` header | Add your API key as the `authentication-key` header |\n| 403 Invalid token | API key not recognized | Verify your key at [console.kochava.com](https://console.kochava.com) |\n| 503 Service unavailable | Auth service temporarily down | Retry in a few seconds |\n| `account_exists` | Company name already registered | Use a different company name or log in at [console.kochava.com](https://console.kochava.com) |\n\n## Support\n\n- **Email**: support@freeappanalytics.com\n- **Console**: [console.kochava.com](https://console.kochava.com)\n\n\n<!-- smithery-verification=96309c88075d1d87e141dfb766db8b75e736ac13f39824dc7a00a03eb4dadc6b -->",
  "bytes": 6345,
  "sha": "4c3a66ad8617c0ac873ec520437d56e76b75513486ef29423782b9ac20b3a9d3",
  "repo_slug": "kochava/kochava-k4a-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kochava_kochava_for_advertiser_08b40077/readme"
}