Tools

Every tool the Analyse MCP server offers, which ones can write, and which plan features they need.

Updated October 7, 20264 min read

Most tools only read. The ones marked Writes create or edit something, and are off unless you turn them on. None of them can delete. Start with list_games to get game ids; every other tool takes a game_id.

Dates are from and to in YYYY-MM-DD, defaulting to the last 30 days.
Money is in US dollar cents.

Tools that write

They are never added on their own:

Apps that sign in: tick Create and edit things for you on the approval screen. To add it to an app that is already connected, connect the app again.
Access tokens: tick the tools you want when you create the token.

What they can do is limited the same way the web app is:

Your role decides. Campaigns, experiments, knowledge, goals and alert settings need an owner or admin. Analysts can make dashboards and segments, and change the ones they made.
Your plan's features and limits apply.
Starting or ending an experiment, and pausing or ending a campaign, affect live players.
They can't delete anything, change where alerts are sent, or touch billing, payouts, API keys or your team. Do those in Analyse.

Metrics

Tool	What it returns
`list_games`	The games this connection can read
`query_metrics`	Any metric the dashboards can show
`compare_periods`	Two date ranges side by side, with the change

Dashboards

Tool	What it does	Writes
`read_dashboard`	Lists saved custom dashboards and what this game's tiles may use, or returns one dashboard with each tile's definition and data
`create_dashboard`	Makes a new custom dashboard with tiles	Yes
`update_dashboard`	Renames a dashboard, or adds, replaces, removes and reorders its tiles	Yes

Players

Tool	What it does	Needs	Writes
`list_players`	Search and list player profiles, with their tags
`read_player`	One player: sessions, spend, timeline and tags
`list_segments`	Saved segments and how many players match	Segments (Starter+)
`list_events`	The events and properties the game sends
`create_segment`	Saves a new segment from conditions	Segments (Starter+)	Yes
`add_players_to_segment`	Adds players to a saved segment by hand		Yes
`tag_players`	Puts a tag on up to 200 players		Yes
`untag_players`	Takes a tag off up to 200 players		Yes

Analysis

Tool	What it returns	Needs
`run_funnel`	A funnel of 2 to 8 steps	Explore (Pro+)
`run_cohort`	Retention by join cohort	Retention
`run_query`	A custom query, like the Explore builder	Explore (Pro+)

Growth

Tool	What it does	Needs	Writes
`read_campaigns`	Campaign spend, attribution and return, with each campaign's links, hostnames and codes	Campaigns (Starter+)
`read_sources`	Traffic sources and creator codes	Acquisition (Starter+)
`read_experiments`	Experiment results and significance, and what an experiment in this game may use	Experiments (Pro+)
`create_campaign`	Makes a campaign with its short link, hostnames and creator code	Campaigns (Starter+)	Yes
`update_campaign`	Edits a campaign, or pauses, resumes or ends it	Campaigns (Starter+)	Yes
`create_experiment`	Sets up an A/B test, as a draft or running	Experiments (Pro+)	Yes
`update_experiment`	Renames or edits a test, or starts, extends or ends it	Experiments (Pro+)	Yes

Revenue

Tool	What it returns
`read_revenue`	Revenue, ARPU and the package breakdown
`read_transactions`	Individual purchases and refunds

Export

Tool	What it returns
`export_csv`	A result set as CSV, up to 5,000 rows

Knowledge

Tool	What it does	Needs	Writes
`search_knowledge`	Pages in the game's Knowledge that match a search	Knowledge (Pro+)
`read_knowledge_page`	One Knowledge page, with the revision a write needs	Knowledge (Pro+)
`create_knowledge_section`	Adds a section	Knowledge (Pro+)	Yes
`create_knowledge_page`	Adds a page, optionally with its text	Knowledge (Pro+)	Yes
`update_knowledge_page`	Renames a page or changes its icon	Knowledge (Pro+)	Yes
`write_knowledge_page`	Appends to a page's text or replaces it. Refused if someone saved the page since it was read	Knowledge (Pro+)	Yes

Settings

Tool	What it does	Writes
`read_goals_and_alerts`	Monthly goals, alert rules and thresholds, recent alerts, quiet hours and the digest. Never the webhook address
`update_goals`	Sets, changes or removes monthly goals	Yes
`update_alert_settings`	Turns alert rules and channels on or off, and changes thresholds, quiet hours and the digest. It can't set where alerts are sent	Yes

Tools your plan does not include are hidden from the client's tool list, so the app never tries to call them.