Read data

Connect an AI assistant

Ask your AI assistant about your traffic through our MCP (Model Context Protocol) server. It answers with the same numbers as your dashboard.

Best for: Any team member
Prerequisites: An AI assistant that supports MCP, such as Claude, ChatGPT or Cursor.

1
Step 1: Copy the server URL
The URL is the same for every account. You'll sign in when you connect.
URL
```
https://staging.pebbleanalytics.io/api/mcp
```
2
Step 2: Add it to your assistant
In Claude or ChatGPT, go to Settings, add a custom connector and paste the URL. In Cursor or another editor, add it to your MCP config:
JSON.cursor/mcp.json
```
{
  "mcpServers": {
    "pebble-analytics": {
      "url": "https://staging.pebbleanalytics.io/api/mcp"
    }
  }
}
```
Step 3: Sign in and approve access
Your assistant opens our sign-in page. Sign in, choose which sites it can access and approve. Your assistant never sees your password.
4
Step 4: Ask about your traffic
- “How many visitors did fieldnotes.blog have last week?”
- “Which pages brought the most visitors this month?”
- “Where did yesterday's visitors come from?”
Done: You're connected
Your assistant has read-only access to your stats. Manage or disconnect it on the AI assistants page.

Available tools

Your assistant picks the right tool for each question. All tools are read-only.

list_sitesnone: Sites the assistant can access.
get_trafficsite, range: Visitors, pageviews and time on page, with daily totals.
get_topsite, range, table: Top pages, referrers, countries, devices or browsers, with visitors for each.
get_eventssite, range: Custom events and their counts.

range can be today, 7d, 30d, 12m or 3y. All dates are in UTC.