Docs
Connect Treval to Claude and ChatGPT
Treval AI Analytics lets Claude and ChatGPT read your Treval analytics, so you can ask about traffic, AI referrals and AI crawlers in plain language and get answers from your own numbers. Access is read-only and you approve it on a Treval sign-in screen.
Before you start
You need a Treval account with at least one site that has the snippet installed. Create a free account if you do not have one. Every plan, including Free, can connect.
Claude
- In Claude, open Settings → Connectors and search the directory for Treval AI Analytics. Or choose Add custom connector and enter
https://treval.app/mcp. - Choose Connect. Sign in to Treval if asked, check the list of sites and choose Allow.
- Start a chat and ask about your site. Claude asks before its first tool call; you can allow the read-only tools permanently.
Claude Code: claude mcp add --transport http treval https://treval.app/mcp, then run /mcp to sign in.
ChatGPT
- In ChatGPT, open the app directory and search for Treval AI Analytics, then choose Connect.
- Sign in to Treval if asked, check the list of sites and choose Allow.
- Mention Treval in a message, or pick it from the tools menu, and ask your question.
The ChatGPT endpoint is https://treval.app/mcp/chatgpt. It has the fixed reports below but not the SQL tools.
Tools
Every tool is read-only. Tools that take a site accept its domain; with one site on the account it can be left out. Periods are today, 24h, 7d, 30d, 90d and 12mo, in the site's timezone.
| Tool | Returns | In |
|---|---|---|
list_sites | Sites the account can read, with domain, role and timezone | Both |
get_overview | Visitors, pageviews, bounce rate, conversions, revenue, AI share, top channels and AI assistants, against the previous period | Both |
get_traffic_trend | Visitors, pageviews, AI visitors, conversions and revenue per hour, day or month, optionally for one channel | Both |
get_breakdown | Traffic ranked by channel, AI assistant, referrer, UTM, page, landing or exit page, country, region, city, browser, OS or device | Both |
get_top_pages | Top pages, and the pages AI assistants send people to | Both |
get_ai_traffic | AI bot hits by purpose, bot hit rate, spoofed bots, errors served to bots and each AI vendor's reads against the visitors it sent | Both |
get_conversions | Each goal's completions, conversion rate and revenue, optionally for one channel | Both |
get_schema | The analytics tables and their columns | Claude |
run_sql | One read-only PostgreSQL SELECT against Treval's analytics tables for one site, up to 200 rows | Claude |
Things to ask
- How many visitors did ChatGPT send to my site this month, and which pages did they land on?
- Compare this week's traffic with last week. What changed, and which channel explains it?
- Which AI crawlers read my site in the last 7 days, and are any of them spoofed or hitting errors?
- Did visitors from AI assistants convert better or worse than search visitors over the last 90 days?
- Show me the top landing pages from Perplexity and Claude, with their conversion rates.
What the assistant can and cannot do
- It can read analytics for sites you own or belong to, including sites you add later.
- It cannot change settings, goals or tracking, delete data or invite people.
- Treval receives only the tool calls, never your conversation. See the privacy policy.
Disconnect
Open Account → Connected apps and choose Disconnect, or remove the connector in Claude or ChatGPT. Access stops immediately.
Troubleshooting
- “This account has no sites yet”: add a site in Treval and install the snippet, then ask again.
- “This account has N sites”: name the site in your question, for example “on example.com”.
- Numbers are zero: the snippet may not be installed yet. Treval shows the install status on the site's Setup page.
- Asked to sign in again: connections refresh themselves for 60 days of inactivity; after that, reconnect.
Other MCP clients
Any MCP client that supports OAuth can use https://treval.app/mcp. Clients without OAuth can use a per-site API token from a site's Settings page with https://treval.app/api/mcp and an Authorization: Bearer header.
Support
Email support@treval.app. We reply within two working days.