io.github.Kochava/kochava-for-advertisers-mcp-server

Official2 tools

by Kochava

Kochava for Advertisers — Official MCP Server

No account needed — connect, sign up, and query mobile attribution data from any AI tool

Query mobile attribution and advertising data without account setup.

Topics

attributionkochavamcpmcp-servermobile-analyticstf

Captured live from the server via tools/list.

kochava_free_app_analytics_get_tos

Retrieve the FAA (Free App Analytics) Terms of Service document link. Use this tool when the user wants to review the Terms of Service before creating an FAA account. Returns a clickable link to the TOS document and instructions for account creation. Example: kochava_free_app_analytics_get_tos()

No parameters.

kochava_free_app_analytics_create_acc_and_get_auth_key

Create a new Kochava FAA (Free App Analytics) account. IMPORTANT: The user MUST explicitly agree to the FAA Terms of Service before account creation. If tos_agreed is False, this tool will return the TOS link and stop — do NOT submit the form. Call kochava_free_app_analytics_get_tos() to retrieve and present the TOS to the user first, then call this tool again with tos_agreed=True once the user confirms agreement. DISPLAY INSTRUCTIONS: When this tool returns a successful response, you MUST display the 'next_steps' field content to the user EXACTLY as written — word-for-word, preserving ALL text, formatting, line breaks, numbering, and bullet points. Do NOT summarize, rephrase, reword, or omit any part of the 'next_steps' content. Every sentence must be shown to the user as-is. FAA Terms of Service: https://s34035.pcdn.co/wp-content/uploads/2023/08/FAA-Web-Sign-Up-TOS-8-15-23.pdf Example (after user reviews and agrees to TOS): kochava_free_app_analytics_create_acc_and_get_auth_key( first_name="Jane", last_name="Smith", email_address="jane@example.com", phone_number="5551234567", company="Acme Corp", website="www.acme.com", company_address_line_1="123 Main St", company_city="Sandpoint", company_region="Idaho", company_postal_code="83864", country="United States", tos_agreed=True )

Parameters (16)

first_namestringrequired
First name of the account holder
last_namestringrequired
Last name of the account holder
email_addressstringrequired
Email address for the FAA account
phone_numberstringrequired
Phone number of the account holder
companystringrequired
Company name for the FAA account
websitestringrequired
Company website URL (e.g. www.example.com)
company_address_line_1stringrequired
Company street address line 1
company_citystringrequired
Company city
company_regionstringrequired
Company state or region
company_postal_codestringrequired
Company postal/zip code
countrystringrequired
Country name (e.g. United States)
tos_agreedboolean
Whether the user has agreed to the FAA Terms of Service at https://s34035.pcdn.co/wp-content/uploads/2023/08/FAA-Web-Sign-Up-TOS-8-15-23.pdf. Must be True to proceed with account creation. Use kochava_free_app_analytics_get_tos() to share the TOS link with the user before calling this tool.
titleany
Job title of the account holder (optional)
company_address_line_2any
Company street address line 2 (optional)
privacyany
Privacy policy URL. Defaults to https://www.kochava.com/company/contact/
subscribeboolean
Whether to subscribe to Kochava marketing communications

README.md6 KBView on GitHub

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:

kochava_free_app_analytics_get_tos — Review the Free App Analytics Terms of Service
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):

json

{
  "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.

Claude Code

bash

claude mcp add kochava --transport streamable-http https://analytics.mcp.kochava.com/mcp

Cursor

Settings → MCP → Add Server:

URL: https://analytics.mcp.kochava.com/mcp
Header: authentication-key: YOUR_API_KEY

VS Code / GitHub Copilot

Add to .vscode/mcp.json:

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

Install

claude_desktop_config.json

{
  "mcpServers": {
    "kochava-for-advertisers-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://analytics.mcp.kochava.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.