MCP Setup
Connect Claude or ChatGPT to explore your Hardal reports in plain language.
Hardal MCP connects your AI assistant to your Hardal reports. Ask questions about campaigns, traffic, events, products, funnels, and AI agent visits without writing SQL or API requests.
MCP (Model Context Protocol) is the connection standard your assistant uses to request data from Hardal. You sign in with your Hardal account and choose which tenants it can access.
Before you connect
You need:
- A Hardal account with access to the tenants you want to analyze.
- Data in those tenants for the reports you want to use.
- An AI client that supports remote MCP connections with OAuth sign-in. Your plan or workspace administrator may control whether you can add a custom connection.
You do not need an Analytics API key, a local installation, or a developer environment.
Hardal MCP is read-only. It reads reports and workspace information; it cannot change tracking, attribution settings, destinations, members, or saved funnels.
Connect to Hardal
Use this MCP server URL:
https://mcp.hardal.ai
The switch to this domain is in progress. If the server is unavailable, wait for the migration to finish before creating or reconnecting a connection.
Add Hardal to your assistant
Create a custom MCP connection using the URL above. Name it Hardal.
Sign in and approve access
Follow the sign-in flow with your Hardal account. Review the requested access and select the tenants you want to share. A tenant is the reporting workspace for a website, app, or other property.
Enable Hardal in a conversation
Enable the connection in your assistant, then ask: "Which Hardal tenants and sources can I analyze?" Choose a tenant and source from the returned list.
Claude
- Open Customize → Connectors and add a custom connector. For a Team or Enterprise workspace, an authorized administrator first adds it in Organization settings → Connectors.
- Enter Hardal and the MCP server URL above.
- Use the sign-in option, complete Hardal authorization, and approve the tenants you need.
- Enable Hardal from the conversation's connector controls.
See Claude's custom connector instructions if your workspace shows different controls.
ChatGPT
- Open Plugins, select the add button, and choose Add custom MCP server.
- Enter Hardal, a short description, and the MCP server URL above. Use that exact URL without adding a path.
- Configure OAuth sign-in, review the connection permissions, and complete the setup.
- Sign in to Hardal when prompted. In a new conversation, select Hardal from the plugin controls or
@menu.
Custom connection controls depend on your account and workspace policy. See OpenAI's connection instructions for the current flow.
Ask your first question
Start by choosing the data you want to analyze:
List the Hardal tenants and sources I can access. Let me choose one before running a report.
Then ask a specific question:
For the selected tenant's Website source, show sessions and page views from November 1 through November 7, 2026 in Europe/Istanbul. Show the top traffic channels too, and state the dates, source, and filters used.
Follow up with:
Compare that period with the previous seven days. Show the absolute and percentage changes. Separate changes visible in the data from possible explanations.
Use your own tenant and source names. You do not need to look up or paste their IDs; the assistant can obtain them from Hardal.
What you can analyze
| Report area | What you can ask | Example |
|---|---|---|
| Traffic | Totals, trends, geographic and device breakdowns, and recent activity | "Summarize sessions and page views for our Website source over the last seven days." |
| Acquisition | Channels, sources, campaigns, and conversion performance | "Rank campaigns by conversions last week. State the attribution model, lookback window, and traffic scope used." |
| Pages | Top pages, entry and exit pages, trends, and Page Flow | "Which paths most often lead to /request-demo?" |
| Events and sessions | Event counts, event trends, session metrics, and engagement | "Show daily generate_lead counts for the last 30 days." |
| Commerce | Revenue, orders, product and category performance, and item attribution | "Which products generated the most revenue last week? Show the sources credited for the top product." |
| AI Visibility | AI agent activity by agent, platform, category, and page | "Which pages received the most AI agent visits last week?" |
| Funnels | Saved funnels, step conversion, drop-offs, and previews | "List my saved funnels, then show where visitors dropped off in the signup funnel last week." |
| Period comparison | Overview or Acquisition scorecards across two periods | "Compare this week's Acquisition scorecards with the previous week using the same settings." |
Available results depend on the tenant's report type and collected data. For example, product analysis needs commerce events and item data. Not every filter is supported by every report.
You can also ask the assistant to preview a funnel without saving it. This calculates results for the requested steps; it does not create or edit a saved funnel.
Get consistent results
Include the tenant, source, dates, and timezone in important requests. For campaign analysis, also specify the attribution model, lookback window, traffic scope, and conversion event when relevant.
- Dates: Calendar reports default to Last 7 days if you do not specify a period. Explicit start and end dates are inclusive. A calendar report period can contain up to 90 days.
- Timezone: The default is Europe/Istanbul. Ask for a different timezone explicitly when needed.
- Sources: Omitting the source includes all sources for the selected tenant.
- Attribution: Acquisition can use the tenant's configuration or supported overrides for the request. An override does not change Dashboard settings.
- Realtime: Recent activity uses a rolling time window rather than a calendar date range.
- Lists: Results may be paginated or limited. Ask for the next page when more rows are available; a top list is not a complete export.
When checking an answer against the Dashboard, use the same dates, timezone, source, report, and applicable settings. Newly arriving data can change totals between requests. Missing data should not be treated as zero.
For metric definitions, see the Metrics Glossary. For campaign reporting, see How Attribution Works.
Available tools
Your assistant selects tools from your question. These names can help you understand its activity or troubleshoot a request.
| Tool | Purpose |
|---|---|
get_context | List the organizations, tenants, sources, report types, and reporting currencies you can access. |
get_overview | Read summaries and supported trends for traffic, realtime, Pages, Sessions, Commerce, and AI Visibility. |
get_breakdown | Read acquisition tables, report breakdowns, Page Flow, item details, and AI page-by-agent activity. |
compare_periods | Compare Overview or Acquisition scorecards across two periods. |
get_events | Read aggregate event metrics, timelines, and available event names. |
get_funnels | List saved funnels, read definitions and results, and preview a funnel without saving it. |
Access and privacy
The connection is limited by both your current Hardal permissions and the tenants you approve. An assistant cannot use it to access a tenant outside that scope.
Hardal MCP returns aggregate reports and workspace metadata, rather than individual visitor records or session event logs. Report dimensions can include page paths, campaign names, product names, and other labels supplied by your implementation.
Report results are shared with the AI assistant you connect. Review your organization's data-sharing policy and the assistant provider's data controls before connecting. Keep personal or confidential information out of tracking labels and page paths.
To revoke access, open your organization's settings in Hardal, find Connected Apps, and disconnect the connection. To change the approved tenants, reconnect and review the tenant selection. You can also disable Hardal for an individual conversation using your assistant's controls.
Troubleshooting
| Problem | What to do |
|---|---|
| The server cannot be found | Use https://mcp.hardal.ai without /mcp. If the domain migration is still in progress, try again after it is complete. |
| Custom connections are unavailable | Ask your AI workspace administrator to enable or add the connection. |
| A tenant is missing or access is denied | Check the Hardal account used to sign in and the tenants approved during authorization. Reconnect if you need to change that selection. |
| A report is empty | Check the tenant, source, dates, and whether the required events have been collected. |
| A filter is unsupported | Ask which filters that report supports, then revise the request. |
| The result is too large | Shorten the date range, use a coarser time interval, or request fewer rows. |
| A product detail selection has expired | Ask for the product list again, then select the product to inspect. |
| The answer differs from the Dashboard | Match the dates, timezone, source, and applicable attribution or conversion settings. Ask the assistant to show the scope used. |
If a request still fails, contact support@usehardal.com with the client name, report area, date range, and error message. Do not include passwords, API keys, or access tokens.
For reports from your own scripts and integrations, use the Analytics API.