MCP Server Documentation
Connect your Lytical analytics data to AI assistants like Claude and ChatGPT using the Model Context Protocol (MCP).
Overview
The Lytical MCP Server provides read-only access to your website analytics, SEO data, and marketing insights directly within your AI assistant. Ask questions in natural language and get instant answers about your traffic, top pages, visitor behavior, and more.
Quick Start
Connecting via Claude
- Open Claude settings
- Navigate to Connectors or MCP Servers
- Search for "Lytical" or add custom connector manually with Server URL:
https://mcp.lytical.ai - Click Connect and authorize with your Lytical account
- Start asking questions about your analytics!
Connecting via ChatGPT
- In ChatGPT, go to Settings → Apps
- Search for "Lytical" navigate to Advanced Settings → Developer Mode On → Create App
- Name: Lytical
- MCP Server URL:
https://mcp.lytical.ai - Authentication: OAuth
- Create
- Authorize access to your Lytical account
- Your analytics data is now available in conversations
Authentication
Lytical uses OAuth 2.0 for secure authentication. When you connect:
- You'll be redirected to Lytical to sign in
- Grant permission for read-only access to your data
- The connection is established automatically
Your credentials are never shared with the AI assistant. The OAuth token only grants read access to analytics data.
Available Tools
Analytics Tools
| Tool | Description |
|---|---|
| list_sites | List all websites tracked in your Lytical account |
| get_analytics_summary | Get visitors, pageviews, bounce rate, and session duration |
| get_top_pages | See your most visited pages |
| get_top_sources | See where your traffic comes from |
| get_top_referrers | See which websites send you traffic |
| get_landing_pages | See entry pages where visitors first arrive |
| get_device_breakdown | Desktop vs mobile breakdown |
| get_browser_breakdown | Chrome, Safari, Firefox usage |
| get_location_breakdown | Visitor countries |
| get_cities | Visitor cities |
| get_realtime_stats | Active users right now |
| compare_periods | Compare current vs previous period |
| get_timeseries | Daily traffic trends |
| get_utm_campaigns | Marketing campaign performance |
Event Tracking Tools
| Tool | Description |
|---|---|
| get_events | Raw events (pageviews, clicks, scrolls, form submissions) |
| get_events_summary | Aggregated event statistics |
Visitor Tools
| Tool | Description |
|---|---|
| list_visitors | List unique visitors to your site |
| get_visitor | Detailed info about a specific visitor |
| get_visitor_sessions | Session history for a visitor |
| list_tracking_links | Your shortened URLs and click stats |
SEO Tools
| Tool | Description |
|---|---|
| list_scans | List SEO crawls/audits for your site |
| get_scan | Detailed SEO scan results with scores and issues |
| get_scan_pages | Page-by-page SEO analysis |
| list_keywords | Tracked keywords with rankings |
| get_keyword | Detailed keyword info with ranking history |
Google Integration Tools
| Tool | Description |
|---|---|
| get_search_queries | Google Search Console query data |
| get_search_pages | Search Console page performance |
| get_ads_performance | Google Ads campaign metrics |
Example Prompts
Here are some things you can ask:
Traffic Analysis
- "What's my website traffic looking like this month?"
- "Show me my top 10 pages by pageviews"
- "Where is my traffic coming from?"
- "Compare my traffic this week vs last week"
SEO Insights
- "Run an SEO audit on my site"
- "What SEO issues should I fix first?"
- "How are my keywords ranking?"
- "Show me pages with missing meta descriptions"
Visitor Behavior
- "What devices do my visitors use?"
- "Which countries do my visitors come from?"
- "What are my top landing pages?"
- "Show me my UTM campaign performance"
Real-time
- "How many people are on my site right now?"
- "What happened on my site today?"
Time Periods
Most tools accept a period parameter:
| Period | Description |
|---|---|
| today | Current day |
| yesterday | Previous day |
| last_7_days | Past 7 days (default) |
| last_30_days | Past 30 days |
| last_90_days | Past 90 days |
| this_month | Current calendar month |
| last_month | Previous calendar month |
Data Security
- Read-only access: The MCP server can only read data, never modify it
- OAuth 2.0: Industry-standard secure authentication
- No conversation logging: Lytical does not see or store your AI conversations
- Scoped access: Only your account's data is accessible
Troubleshooting
"Site not found" error
- Ensure you have at least one website set up in Lytical
- Check that the site_id matches a site in your account
"Unauthorized" error
- Your OAuth token may have expired
- Disconnect and reconnect the Lytical integration
- Ensure you're signed into the correct Lytical account
No data returned
- Verify your site has the Lytical tracking script installed
- Check that data exists for the requested time period
- Some features (Search Console, Google Ads) require separate integrations
Search Console / Google Ads not working
- These require additional OAuth connections in Lytical
- Go to Lytical Settings → Integrations to connect Google services
Support
- Email: support@lytical.ai
- In-app: Use the Support page in your Lytical dashboard
Changelog:
Current Version: 1.0.0 (12-27-2025)
- Initial release
- 29 MCP tools for analytics, SEO, and marketing data
- OAuth 2.0 with Dynamic Client Registration
- Streamable HTTP transport (MCP 2025-06-18 spec)