MCP Tools

This page lists the tools the Attribution MCP server makes available to AI assistants by default. All data tools are read-only — the server cannot write, modify, or delete any of your Attribution data, settings, or configurations. The one exception is logout, which ends your own MCP session (see Session).

For how to connect and authenticate, see Attribution MCP Server.

The tools are grouped into the following categories, each gated by the OAuth scopes it requires:

Category	Tools	Required scopes
Project	3	`project:read`, `account:read`
Filters	2	`filters:read`
Reporting	1	`reports:read`
Reports	3	`reports:read`
Session	1	—

Project

Tools that describe the current Attribution project — views and available attribution models.

Tool	What it does
`get_project_context`	Load project views and filter tree summary in a single call.
`list_project_views`	List saved project views (dashboard presets) with their conversion event, attribution model, and date range.
`list_attribution_models`	List all available attribution models (linear, time decay, position-based, etc.).

Filters

Tools for reading Attribution's channel hierarchy — the filters and filter groups that organize your traffic.

Tool	What it does
`get_filter_tree_markdown`	Filter tree as readable markdown, 2 levels deep — channel names, IDs, integration types.
`get_filter_tree`	Flat JSON list of all filter and group nodes with full metadata (id, name, type, depth, parent, integration, visibility).

Reporting

Discovery for the conversion and revenue events your reports run against.

Tool	What it does
`list_event_names`	List all tracked event names (conversions, revenue events) with their source info.

Reports

The dashboard reports — channel-level performance and period-over-period comparison.

Tool	What it does
`get_dashboard_report`	Dashboard report — visits, conversions, revenue by channel (returned as a markdown table).
`get_dashboard_comparison`	Period-over-period comparison of two dashboard reports in one side-by-side table — Δ$ / Δ% per channel, total deltas, top profit gains/drops, and sign-flips. Use for "vs last month / quarter / year" and "what changed" questions.
`log_report_issue`	Flag a report that returned empty data, all zeros, or unexpected results — helps Attribution debug.

Session

Tools for managing your own MCP session. Always available regardless of which other tools your project has enabled.

Tool	What it does
`logout`	End the current MCP session — revokes the session's refresh grant upstream and invalidates this access token immediately. The only non-read-only tool.

Tool annotations

Every data tool ships with these MCP annotations so clients know what to expect:

readOnlyHint: true — safe to auto-permission
destructiveHint: false — no data modification or deletion
idempotentHint: true — calling the same tool with the same arguments returns the same result

The one exception is logout, which manages your session rather than your data. It is annotated readOnlyHint: false, destructiveHint: true (it revokes your session), and idempotentHint: true.

Support

For questions about a specific tool, requests for new tools, or to report incorrect tool behavior, email [email protected].