Kochava for Advertisers — Official MCP Server

io.github.KochavaPublished by GitHub account Kochavav1.0.45Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Kochava's remote MCP server lets an assistant query mobile attribution analytics, run reports, and manage campaigns, trackers and segments, with in-session free

What you can do
Review Free App Analytics terms and create a free account, receiving an API key in the conversation without an existing account. List apps, dimensions and currencies, and run analytics queries for events, explorer data, funnels, lifetime value and retention. Search report tables, list saved queries, execute report queries and fetch results. List, create and update campaigns. List, create, update and delete trackers, read tracker metrics, and list media partners, agency networks and tracker events. List, create and update segments.
When to use it
Use it when you work with Kochava mobile attribution data and want an assistant to pull analytics, run saved or ad-hoc reports, or manage campaigns, trackers and segments from a chat client. It is also a low-friction way to try Kochava, since a free account and key can be created during the session.
Requirements
A remote Streamable HTTP endpoint; no local package is needed, though the README's Claude Desktop setup uses npx and therefore Node.js. The authentication-key header carries a Kochava API key; it can be omitted to use only the two free signup tools. Network access to the Kochava endpoint is required.
Before you install
The API key is a secret passed in the authentication-key header; keep it out of shared configs. Creating an account requires explicit agreement to the Free App Analytics Terms of Service, and the key is returned in the conversation. Campaign, tracker and segment tools create, update and delete data in your Kochava account, including tracker deletion. Free App Analytics keeps only 30 days of data.

Installation

In SourceWeft

  1. Open Kochava for Advertisers — Official MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Kochava%2Fkochava-for-advertisers-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "kochava-for-advertisers-official": {
      "type": "http",
      "url": "https://analytics.mcp.kochava.com/mcp"
    }
  }
}

README

Kochava for Advertisers — MCP Server

[MCP Badge]

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:

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

bash
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:

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.

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)

ToolDescription
kochava_free_app_analytics_get_tosGet the FAA Terms of Service link
kochava_free_app_analytics_create_acc_and_get_auth_keyCreate a free account and get an API key in-session

Analytics & Reporting

ToolDescription
get_all_appsList all apps in your account
get_app_dimensionsGet dimensions available for an app
run_search_queryRun an analytics search query
get_event_detailGet event-level detail data
get_explorer_dataQuery the analytics explorer
get_funnel_dataGet funnel analysis data
get_LTV_detailsGet lifetime value details
get_retention_overlayGet retention overlay data
get_currenciesList supported currencies

Report Querying

ToolDescription
search_tablesSearch available report tables
get_saved_queriesList saved report queries
execute_report_queryExecute a report query
get_query_resultsGet results from an executed query

Campaign Management

ToolDescription
kochava_list_campaignsList all campaigns
kochava_get_campaignGet campaign details
kochava_create_campaignCreate a new campaign
kochava_update_campaignUpdate an existing campaign

Tracker Management

ToolDescription
kochava_list_trackersList all trackers
kochava_create_trackerCreate a new tracker
kochava_update_trackerUpdate an existing tracker
kochava_delete_trackerDelete a tracker
kochava_get_tracker_metricsGet tracker performance metrics
kochava_get_all_media_partnersList available media partners
kochava_get_agency_networksList agency networks
kochava_list_events_for_tracker_creationList events available for tracker setup

Segment Management

ToolDescription
kochava_list_segmentsList all segments
kochava_create_segmentCreate a new segment
kochava_update_segmentUpdate 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

ErrorCauseFix
401 UnauthorizedMissing authentication-key headerAdd your API key as the authentication-key header
403 Invalid tokenAPI key not recognizedVerify your key at console.kochava.com
503 Service unavailableAuth service temporarily downRetry in a few seconds
account_existsCompany name already registeredUse a different company name or log in at console.kochava.com

Support

Source: README.md at commit 20ed108

Tools

2

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()

Takes 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="[email protected]", 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 )

Parameterstitlecompanyrequiredcountryrequiredprivacywebsiterequiredlast_namerequiredsubscribefirst_namerequiredtos_agreedcompany_cityrequiredphone_numberrequiredemail_addressrequired+4 more

Version history

1
  1. v1.0.45LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.