Developers

MCP server

Connect an AI agent (Claude Code, Cursor, or any MCP client) to your brands, questions and reports. It uses the same API keys as the REST API.

1. Endpoint

Streamable HTTP transport. Send your key in the Authorization: Bearer header, or as the api_key query parameter for clients that only take a URL.

https://aitrafficanalytics.com/api/mcp

Key for the snippets Stays in this page: it only fills the snippets and is never sent anywhere.

Claude Code

Cursor, VS Code, and other clients with an mcpServers file

Clients that only accept a URL (custom connectors)

The key is part of this URL, so it can end up in logs and browser history. Prefer the header when your client supports it.

Test from a terminal

11 tools

`list_models`	The FreeRouter models saved in Settings. Reports ask these models unless you pass a subset.
`list_brands`	Every tracked brand with its question count, report count, and latest report time.
`get_brand`	A brand's questions and the summary of each of its reports, newest first.
`get_brand_report`	What each model answered to each brand question, with mention counts and coverage.
`run_brand_report`	Ask the chosen models every question on a brand, save the report, and return it. Costs money on the user's FreeRouter key and takes about 15-60 seconds per model. Uses FreeRouter credit
`create_brand`	Start tracking a brand with the questions to ask models about it.
`list_questions`	Every tracked question with its keywords, report count, and schedule.
`get_question`	A tracked question's keywords, schedule, and the summary of each of its reports, newest first.
`get_question_report`	What each model answered to a tracked question, with keyword mention counts.
`run_question_report`	Ask the chosen models a tracked question, save the report, and return it. Costs money on the user's FreeRouter key and takes about 15-60 seconds per model. Uses FreeRouter credit
`create_question`	Start tracking a question. Keywords (brands, products to count in answers) are optional: when omitted, AITrafficAnalytics picks them from the model answers after the first report and keeps tuning them on later runs. Scheduled reports are off unless you set schedule.

Reports need a FreeRouter key and chosen models in Settings. Brands and questions use XXXX-XXXX ids, the same ones in their page URLs.