Connect Claude or Codex

When you finish, you can ask Claude or Codex about your Datalyr analytics without storing an API key anywhere.

https://api.datalyr.com/mcp

The steps below ask for the scope datalyr:read and nothing else, so the token your client receives reads and changes nothing. It is short-lived, and it is never the workspace Agent key. Datalyr never receives your Claude or Codex credentials, and you need no Anthropic or OpenAI API key. The server does expose tools that change conversion rules and trackable links. A token that asked for datalyr:read alone cannot call any of them. See The 8 tools that write or start work.

Before you start

You must have a Datalyr login that belongs to at least one workspace. The server checks your membership on every tool call.

Connect Claude

Open Customize → Connectors in Claude.
Select + → Add custom connector.
Enter Datalyr as the name.
Enter https://api.datalyr.com/mcp as the remote MCP URL.
Select Add.
Select Connect.
Sign in to Datalyr and allow read-only access.

On Claude Team or Enterprise, an Owner first adds the URL under Organization settings → Connectors. Each member then connects their own Datalyr account under Customize → Connectors.

Connect Codex

codex mcp add datalyr --url https://api.datalyr.com/mcp
codex mcp login datalyr --scopes datalyr:read

Complete the Datalyr sign-in and the consent page in your browser.

The 27 read tools

Tool	Returns
`list_workspaces`	Every workspace you can access. Call this first.
`get_overview`	Visitors, pageviews, sessions, custom events, and a time series
`get_traffic`	A breakdown by referrer, campaign, or page
`get_devices`	A breakdown by browser, operating system, or device type
`get_locations`	A breakdown by country, region, or city
`get_events`	Raw events, filtered by name, campaign, country, page, or custom property
`list_event_names`	Distinct event names of the last 30 days
`list_event_properties`	Custom event properties this workspace sends, with a sample value and type
`get_realtime`	Active visitors, pages, events, revenue, and a minute timeline
`get_attribution`	Attribution by channel under a chosen model, with an unattributed bucket
`list_users`	Visitors and identified users, with an optional search
`get_user`	One user’s profile, sessions, journey, and conversions
`get_ads`	Provider-reported spend, delivery, conversions, and ROAS
`get_revenue`	Revenue, orders, subscriptions, refunds, AOV, and a time series
`get_commerce_metrics`	Certified revenue, spend, profit, margin, ROAS, and MER
`list_metrics`	The catalog of metric ids you can query, with units and availability
`query_metrics`	Up to 50 named metrics over a date range, with an optional comparison
`get_retention`	Person-grain retention cohorts, with active persons and revenue per period
`get_ltv`	Cohort LTV: cumulative revenue and revenue per acquired person, period by period
`get_funnel`	An ordered funnel over 2 to 5 event names, with per-step conversion rates
`get_tags`	Tracking-link tag counts and percentages
`get_workspace`	Name, domain, timezone, and connected platforms
`get_onboarding_status`	Plan, whether tracking has ever sent an event, live sources, connection health, and the next steps a person must take
`get_usage`	Plan, and current-period event and postback usage
`search_docs`	Matching pages of this documentation, with a link and an excerpt
`get_script_proposals`	Container-script drafts an agent submitted, and what a human decided
`get_export_status`	One export job’s state, and its download URL once the file exists

The 8 tools that write or start work

The server advertises 8 more tools. A token that asked for datalyr:read alone cannot call any of them. See Agent access for the scopes, the dry-run default, and the undo path.

Tool	Does	Scope
`create_conversion_rule`	Creates a conversion rule. Dry run by default.	`datalyr:write:rules`
`update_conversion_rule`	Edits a conversion rule. Dry run by default.	`datalyr:write:rules`
`delete_conversion_rule`	Deletes a conversion rule. Dry run by default.	`datalyr:write:rules`
`create_link`	Creates a trackable link. Dry run by default.	`datalyr:write:links`
`update_link`	Edits a trackable link. Dry run by default.	`datalyr:write:links`
`delete_link`	Deletes a trackable link. Dry run by default.	`datalyr:write:links`
`propose_container_script`	Submits a container-script draft for review. It publishes nothing.	`datalyr:propose:scripts`
`create_export`	Starts an export job. It returns a job id, never data.	`datalyr:read`

No tool changes tracking, settings, sources, tracking domains, team membership, or billing. No scope publishes a container script. There is no signup tool. MCP needs an OAuth token, and only an existing Datalyr account can hold one. To start a signup for somebody who has no account, call POST /v1/signup. See Agent-driven setup.

Rules the client follows

Rule	Detail
Workspace selection	With one workspace, `workspace_id` can be omitted. With several, pass the ID from `list_workspaces`.
Date defaults	Omit both dates and the tool uses the last 30 days.
Row caps	`get_events` and `list_users` return 1000 rows maximum. `get_ads` returns 200. `get_traffic` returns 100.
Ad platforms	`get_ads` accepts `meta`, `google`, or `tiktok`. It keeps each platform’s money separate.

Tool results carry customer, campaign, and revenue data. Connect only clients and organizations you trust, because anything you connect can read all of it.

An AI client can misread a number it fetched correctly. Check any high-impact decision against the matching report in Datalyr.

Verify

Start a new conversation.
Ask: List my Datalyr workspaces.
Confirm the reply names the workspace you expect.
Ask: Show my Datalyr overview for the last 7 days.
Compare the visitor count with Overview in Datalyr.

When it does not work

Symptom	Cause	Fix
The client reports a `401`	The OAuth token expired or was revoked.	Remove the connector and add it again.
`list_workspaces` returns nothing	Your login belongs to no workspace.	Ask an owner or admin to invite you.
A tool reports an unknown workspace	The client passed a stale ID.	Ask it to call `list_workspaces` again.
A revenue answer looks wrong	`get_revenue` and `get_commerce_metrics` answer different questions.	Use `get_commerce_metrics` for profitability.
The client reports empty data	The date range holds no events.	Ask for a wider range. Confirm events in Events.

Removing Datalyr from your client’s connector settings stops it from requesting new data.

API reference: the same data over HTTP with an Agent key.
API keys: when you need a key instead of OAuth.
AI Chat: ask the same questions inside Datalyr.

Agents and MCP

API Reference

Analytics

Events and users

Attribution and revenue

Cohorts and funnels

Metrics

Workspace

Conversion rules

Trackable links

Exports

Connect Claude or Codex

Before you start

Connect Claude

Connect Codex

The 27 read tools

The 8 tools that write or start work

Rules the client follows

Verify

When it does not work

Next

​Before you start

​Connect Claude

​Connect Codex

​The 27 read tools

​The 8 tools that write or start work

​Rules the client follows

​Verify

​When it does not work

​Next

Before you start

Connect Claude

Connect Codex

The 27 read tools

The 8 tools that write or start work

Rules the client follows

Verify

When it does not work

Next