Kochava for Advertisers — Official MCP Server

Official2 toolsLive

by Kochava

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

This MCP server enables AI tools to query live Kochava mobile attribution data, manage campaigns, and create reports. It is associated with “Kochava for Advertisers,” an omnichannel measurement and attribution platform that includes last-click attribution, incrementality, and MMM tools for brands and their agencies.

🛠️ Key Features

Query live Kochava attribution data
Manage campaigns
Create reports

🚀 Use Cases

Measure and attribute mobile activity from an AI tool
Run campaign workflows and generate measurement outputs
Use attribution methods referenced by Kochava for Advertisers (last-click, incrementality, MMM)

⚡ Developer Benefits

No existing account required: connect and sign up in-session to start querying

⚠️ Limitations

Available features are described only at a high level (the source does not enumerate specific tools beyond toolCount: 2)

Topics: attribution, kochava, mcp, mcp-server, mobile-analytics, tf

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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 )

Parameters16

first_name	string	required	First name of the account holder
last_name	string	required	Last name of the account holder
email_address	string	required	Email address for the FAA account
phone_number	string	required	Phone number of the account holder
company	string	required	Company name for the FAA account
website	string	required	Company website URL (e.g. www.example.com)
company_address_line_1	string	required	Company street address line 1
company_city	string	required	Company city
company_region	string	required	Company state or region
company_postal_code	string	required	Company postal/zip code
country	string	required	Country name (e.g. United States)
tos_agreed	boolean	optional	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.
title	any	optional	Job title of the account holder (optional)
company_address_line_2	any	optional	Company street address line 2 (optional)
privacy	any	optional	Privacy policy URL. Defaults to https://www.kochava.com/company/contact/
subscribe	boolean	optional	Whether to subscribe to Kochava marketing communications

Raw schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "description": "First name of the account holder",
      "type": "string"
    },
    "last_name": {
      "description": "Last name of the account holder",
      "type": "string"
    },
    "email_address": {
      "description": "Email address for the FAA account",
      "type": "string"
    },
    "phone_number": {
      "description": "Phone number of the account holder",
      "type": "string"
    },
    "company": {
      "description": "Company name for the FAA account",
      "type": "string"
    },
    "website": {
      "description": "Company website URL (e.g. www.example.com)",
      "type": "string"
    },
    "company_address_line_1": {
      "description": "Company street address line 1",
      "type": "string"
    },
    "company_city": {
      "description": "Company city",
      "type": "string"
    },
    "company_region": {
      "description": "Company state or region",
      "type": "string"
    },
    "company_postal_code": {
      "description": "Company postal/zip code",
      "type": "string"
    },
    "country": {
      "description": "Country name (e.g. United States)",
      "type": "string"
    },
    "tos_agreed": {
      "default": false,
      "description": "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.",
      "type": "boolean"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "",
      "description": "Job title of the account holder (optional)"
    },
    "company_address_line_2": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "",
      "description": "Company street address line 2 (optional)"
    },
    "privacy": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "https://www.kochava.com/company/contact/",
      "description": "Privacy policy URL. Defaults to https://www.kochava.com/company/contact/"
    },
    "subscribe": {
      "default": true,
      "description": "Whether to subscribe to Kochava marketing communications",
      "type": "boolean"
    }
  },
  "required": [
    "first_name",
    "last_name",
    "email_address",
    "phone_number",
    "company",
    "website",
    "company_address_line_1",
    "company_city",
    "company_region",
    "company_postal_code",
    "country"
  ]
}

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

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

Tools (2)

kochava_free_app_analytics_get_toskochava_free_app_analytics_create_acc_and_get_auth_key

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://analytics.mcp.kochava.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

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.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

kochava_free_app_analytics_get_tos

kochava_free_app_analytics_create_acc_and_get_auth_key

Kochava for Advertisers — MCP Server

No Account? No Problem.

Connect

Claude Desktop

Claude Code

Cursor

VS Code / GitHub Copilot

Tools

Free App Analytics (no auth required)

Analytics & Reporting

Report Querying

Campaign Management

Tracker Management

Segment Management

Authentication

Troubleshooting

Support

Install

Remote endpoint

Related servers