
AttriKit MCP server (@attrkit/mcp): run web-to-app attribution for iOS and Android apps from Claude
AttriKit MCP server (@attrkit/mcp): run web-to-app attribution for iOS and Android apps from Claude, Cursor, Codex, Gemini or VS Code. https://attrikit.io
·
A stdio MCP server for AttriKit, web-to-app attribution for iOS and Android apps that buy ads. Use it from Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, VS Code or Windsurf to create campaign links, import spend, read each campaign's scale, cut or hold call, and export installs and events. It is a thin client over AttriKit's public API. It holds no database access; your tenant scope is resolved from your secret management key.
Source: KamyarTaher/attrikit-mcp. Report an issue there or at [email protected]. MIT licensed.
The server provides 39 tools.
| Area | Tools |
|---|---|
| Key scope | whoami |
| Workspace usage | get_usage_cap, set_usage_cap |
| Apps | list_apps, create_app, get_app, update_app, archive_app |
| SDK keys | get_publishable_key, rotate_publishable_key |
| Management keys | list_api_keys, create_api_key, revoke_api_key |
| Campaign links | list_links, create_campaign_link, update_link_status |
| Decisions and reporting | list_campaigns, list_ads, list_recent_events, list_event_deliveries, get_campaign_decision, record_campaign_decision, get_attribution_rollup, lookup_customer_attribution |
| Spend and costs | get_spend, import_spend, set_cost_model, pull_network_spend |
| Ad integrations | list_integrations, create_integration, update_integration, delete_integration |
| RevenueCat | get_revenuecat, configure_revenuecat |
| Outbound webhooks | list_webhooks, create_webhook, delete_webhook |
| Data export | export_events |
| Server events | send_server_event |
get_campaign_decision returns the engine's call verbatim. The model reports it;
it does not recompute it.
A Meta or TikTok integration has two delivery options. delivery_scope is all
(the default: every install with measurement consent, organic ones included) or
attributed (only installs AttriKit attributes to that network: a click ID, a link
token, or a Matched install at or above the delivery floor). renewal_event
is purchase (the default: a renewal is sent as Purchase) or custom (it is
sent as the custom event subscription_renewed, with its value). Set them on
create_integration, or later with update_integration and the action
set_delivery_options, which leaves the credential and status as they are. A
Google integration refuses attributed and custom.
delivery_scope_overrides sets the scope per country: an object of upper-case
country code to all or attributed, for example {"MX": "all"} to send every
install made in Mexico while delivery_scope stays attributed elsewhere. The
country is the install's own, taken from the request IP at its first open; an
install whose country has no entry, or has none, takes delivery_scope. On
set_delivery_options the object replaces the whole map, and {} clears it.
Install Node.js 22 or newer. The npx -y @attrkit/mcp command downloads and
starts the server automatically, so no global install is required.
Node.js 22 is required from 2.0.0.
engines.nodeis>=22; 1.x accepted Node.js 18. If a client still starts the server with an older Node, upgrade Node, or pin@attrkit/mcp@1. The tools, their inputs and their outputs did not change.
Create the first workspace management key under Dashboard → Settings → API keys & MCP. This one-time bootstrap requires the dashboard.
After that first key exists, a workspace-scoped read/write key can manage every customer operation available through the Management API. This includes apps, delegated keys, usage caps, integrations, and exports.
Use a read-only or app-scoped key when the client needs less access. App-scoped keys cannot read or change the workspace usage cap, create sibling apps, or manage workspace-wide integrations.
On macOS, store the key once in the Keychain:
npx -y @attrkit/mcp loginIt asks for the key with echo off, checks it against AttriKit (and prints the plan and scopes),
then stores it in the Keychain item attrkit-mcp. The key never appears in a process listing.
npx -y @attrkit/mcp logout removes the item.
On any system you can instead set ATTRKIT_API_KEY in the environment of the process that starts
your MCP client, or in the client's own secret store.
At start the server resolves the key in this order:
ATTRKIT_API_KEY, when it holds a real value.attrkit-mcp. An empty ATTRKIT_API_KEY, or one a client left
unexpanded ($ATTRKIT_API_KEY, ${ATTRKIT_API_KEY}, ${ATTRKIT_API_KEY:-},
${env:ATTRKIT_API_KEY}, ${input:attrkit-key}), counts as unset.Add this server to ~/.codex/config.toml:
[mcp_servers.attrkit]
command = "npx"
args = ["-y", "@attrkit/mcp"]
env = { ATTRKIT_API_URL = "https://attrikit.io" }
env_vars = ["ATTRKIT_API_KEY"]codex mcp get attrkitSee the Codex setup guide.
Add the server to .cursor/mcp.json for one project or ~/.cursor/mcp.json for
every project:
{
"mcpServers": {
"attrkit": {
"command": "npx",
"args": ["-y", "@attrkit/mcp"],
"env": {
"ATTRKIT_API_KEY": "${env:ATTRKIT_API_KEY}",
"ATTRKIT_API_URL": "https://attrikit.io"
}
}
}
}Then enable it and inspect the available tools:
cursor-agent mcp list
cursor-agent mcp list-tools attrkitSee the Cursor setup guide.
Add this server to ~/.gemini/settings.json:
{
"mcpServers": {
"attrkit": {
"command": "npx",
"args": ["-y", "@attrkit/mcp"],
"env": {
"ATTRKIT_API_KEY": "$ATTRKIT_API_KEY",
"ATTRKIT_API_URL": "https://attrikit.io"
}
}
}
}gemini mcp listSee the Gemini setup guide.
Configure a stdio server with command npx, arguments
["-y", "@attrkit/mcp"], and the ATTRKIT_API_KEY environment variable.
Environment-variable interpolation differs between clients, so follow the
client's secret-handling documentation. ATTRKIT_API_URL is optional and
defaults to https://attrikit.io.
Tool input schemas are snake_case (bundle_id, store_url, campaign_id) and
double as REST documentation: the Management API accepts the same snake_case
field names in query strings and JSON request bodies (camelCase also works),
and responses are always snake_case. Field-level detail is returned under
error.fields when a validation failure can be attributed to specific fields.
Malformed JSON has no field to name. Self-identifying rejections such as
invalid_cursor, invalid_url, and ssrf_blocked return the code alone.
ATTRKIT_API_KEY=sk_... npx @modelcontextprotocol/inspector npx -y @attrkit/mcpThe Inspector lists the tools and lets you invoke them against your live workspace.
| Control | Management API and MCP |
|---|---|
| Customer operations after the first key | Available with a workspace-scoped read/write key |
| First workspace management key | Dashboard bootstrap only |
| Billing and subscription | Not available |
| Sign-in and organization membership | Not available |
| Workspace deletion | Not available |
| Internal administration | Not available |
See the Management API guide and OpenAPI contract for the complete HTTP surface.
403 forbidden_scope on
every mutation.idempotency_key. Reuse the
same value only for an exact retry. One-time secret responses are encrypted at
rest and safely replayed. Removal tools do not accept this parameter because
their DELETE operations cannot apply the removal more than once.429 response includes Retry-After; wait at
least that many seconds before retrying.Version 1.0.0 formalizes tool input schemas, refines runtime configuration validation, and introduces three breaking restrictions from version 0.4.6:
import_spend: adset_id and ad_id (and their camelCase aliases adsetId and adId) must now be provided together or both omitted. At version 0.4.6 the schema accepted either field independently, but the underlying API rejected unpaired calls; version 1.0.0 moves this validation client-side.campaign_id in record_campaign_decision: campaign_id must now be a valid RFC 4122 UUID. Version 0.4.6 accepted arbitrary non-empty strings.readConfig (ATTRKIT_API_URL): readConfig enforces four startup-fatal refusals (violations print to stderr and exit with code 1):
protocol must be HTTPS, except HTTP is allowed for localhost development). HTTP is permitted only for loopback interfaces (localhost, 127.0.0.1, [::1]); remote hosts must use https:.credentials are not allowed in ATTRKIT_API_URL). Pass API authentication via ATTRKIT_API_KEY.query strings are not allowed in ATTRKIT_API_URL).fragments are not allowed in ATTRKIT_API_URL).
(In addition, malformed strings that fail URL parsing throw Invalid URL and exit 1).Additionally, dot-segment ids escaped the app route under 0.4.6-style encoding; 1.0.0 keeps them inside the route across all seven app tools (get_app, update_app, archive_app, get_publishable_key, rotate_publishable_key, get_revenuecat, and configure_revenuecat).
See CHANGELOG.md for full release details.
MIT. See LICENSE.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add attrkit -- npx -y @attrkit/mcp{
"mcpServers": {
"attrkit": {
"env": {
"ATTRKIT_API_KEY": "",
"ATTRKIT_API_URL": ""
},
"args": [
"-y",
"@attrkit/mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"attrkit","env":{"ATTRKIT_API_KEY":"","ATTRKIT_API_URL":""},"args":["-y","@attrkit/mcp"],"command":"npx"}'[mcp_servers.attrkit]
command = "npx"
args = ["-y", "@attrkit/mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/attrkit-mcp to learn what the "@attrkit/mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y @attrkit/mcp loginThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its npm package has not answered in our offline sandbox, which usually means it needs an API key or other configuration to start. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/attrkit-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "attrkit-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.