# Recometrix > Recometrix shows brands whether AI tools like ChatGPT, Gemini, Perplexity, and Claude recommend them, who gets recommended instead, and what to change to close the gap. Recometrix runs your buyers' real questions through the major AI tools on a schedule, samples each question several times because answers vary, and turns the results into visibility scores, competitor comparisons, cited-source lists, and concrete fixes. The first audit is free. Ongoing monitoring is a paid subscription, and every paid plan covers every AI tool. ## Pages - [Home](https://recometrix.com/): what the product does and how the audit works - [Blog](https://recometrix.com/blog): notes from running AI visibility audits - [Best AI visibility tools in 2026](https://recometrix.com/blog/best-ai-visibility-tools-2026): honest shortlist and buying criteria - [Profound vs Peec AI vs Recometrix](https://recometrix.com/blog/profound-vs-peec-ai-vs-recometrix): side-by-side vendor comparison - [Profound alternatives](https://recometrix.com/blog/profound-alternatives): AI visibility alternatives to Profound - [Peec AI alternatives](https://recometrix.com/blog/peec-ai-alternatives): AI visibility alternatives to Peec AI - [What is generative engine optimization?](https://recometrix.com/blog/what-is-generative-engine-optimization): GEO definition and measurement guide - [GEO vs AEO vs SEO](https://recometrix.com/blog/geo-vs-aeo-vs-seo): plain-language comparison of optimization disciplines - [How ChatGPT picks sources](https://recometrix.com/blog/how-chatgpt-picks-sources): model-memory vs live-search retrieval explanation - [What is llms.txt?](https://recometrix.com/blog/what-is-llms-txt): what llms.txt does and does not do - [Pricing](https://recometrix.com/pricing): plans and what an Action credit is, with no per-tool upcharges - [Methodology](https://recometrix.com/methodology): how we sample AI answers and score visibility - [Transparency](https://recometrix.com/transparency): our own AI visibility numbers, published live - [Public AI rankings](https://recometrix.com/visibility-index): which brands AI tools recommend, measured weekly. - [API docs](https://recometrix.com/docs/api): REST API and MCP server for your visibility data. - [Public report example](https://recometrix.com/s/example): what an opt-in read-only audit share page shows. - [Terms of Service](https://recometrix.com/terms) - [Privacy Policy](https://recometrix.com/privacy) ## Machine-readable public data Visibility Index industry panels expose JSON and CSV snapshots at: - https://recometrix.com/visibility-index/crm-software/data.json - https://recometrix.com/visibility-index/crm-software/data.csv - https://recometrix.com/visibility-index/website-builders/data.json - https://recometrix.com/visibility-index/website-builders/data.csv - https://recometrix.com/visibility-index/project-management/data.json - https://recometrix.com/visibility-index/project-management/data.csv ## API and MCP Everything the dashboard shows is available over a REST API and an MCP server. Create an API key in Settings, then point your code or your AI tools at it. API access is included on the Grow and Agency plans. ### Authentication Send `Authorization: Bearer rmx_YOUR_KEY` on every REST and MCP request. Create keys in Settings, Developers, API keys. The tab only allows key creation when your workspace has API access. New keys are shown once when you create them. Recometrix stores only the hashed key, so create a new key if you lose it. ### REST endpoints Use `https://recometrix.com` as the base URL. Responses are JSON. | Method | Path | Purpose | | --- | --- | --- | | GET | `/api/v1/projects` | List every project available to the API key. | | GET | `/api/v1/projects/{projectId}/metrics` | Return the latest visibility metrics and a 12-run history for one project. | | GET | `/api/v1/projects/{projectId}/answers` | Return prompt-level answers from the latest completed audit. Optional limit query parameter, default 50, max 200. | Response example for `GET /api/v1/projects` ```json { "projects": [ { "id": "6f0c9f0e-2a9d-4b5f-8c1a-2b3c4d5e6f70", "brandName": "AcmeDesk", "websiteUrl": "https://acmedesk.example", "category": "shared inbox software" } ] } ``` Response example for `GET /api/v1/projects/{projectId}/metrics` ```json { "latest": { "runId": "9a8b7c6d-1234-4cde-9f01-3456789abcde", "visibilityScore": 48.6, "mentionRate": 0.42, "top3Rate": 0.25, "citationRate": 0.38, "stability": 0.81, "sampleCount": 144, "competitors": [ { "name": "AcmeDesk", "isBrand": true, "mentions": 61, "share": 0.42, "rank": 2 }, { "name": "InboxPilot", "isBrand": false, "mentions": 73, "share": 0.51, "rank": 1 } ], "at": "2026-07-03T12:20:00.000Z", "perProvider": [ { "provider": "openai", "visibilityScore": 52.1, "mentionRate": 0.46, "citationRate": 0.41, "top3Rate": 0.29, "sampleCount": 36 } ] }, "history": [ { "at": "2026-06-19T12:20:00.000Z", "visibilityScore": 42.4, "mentionRate": 0.36 }, { "at": "2026-07-03T12:20:00.000Z", "visibilityScore": 48.6, "mentionRate": 0.42 } ] } ``` Response example for `GET /api/v1/projects/{projectId}/answers` ```json { "runId": "9a8b7c6d-1234-4cde-9f01-3456789abcde", "answers": [ { "prompt": "Best shared inbox software for a small support team?", "provider": "anthropic", "mode": "memory", "model": "claude-sonnet-4-5", "sampleIndex": 0, "brandMentioned": true, "brandRank": 3, "sentiment": "positive", "citedDomains": [ "g2.com", "capterra.com" ], "answer": "AcmeDesk appears in shared inbox comparisons when teams ask for routing, ownership, and reporting.", "error": null } ] } ``` ### MCP The MCP server lets AI tools use Recometrix directly. Tell Claude to check your visibility, pull prompt-level answers, or list what to fix, and it can call these tools itself. Endpoint: `POST https://recometrix.com/api/mcp`. The server is stateless streamable HTTP, accepts single JSON-RPC 2.0 request objects, and advertises protocol `2025-06-18` during `initialize`. Tool: `list_projects` List the brands/projects tracked in this Recometrix workspace, with their ids. ```json { "type": "object", "properties": {}, "additionalProperties": false } ``` Tool: `get_visibility_metrics` Latest AI-visibility metrics for a project (visibility score, mention rate, top-3 rate, stability, competitor share) plus a 12-run history. ```json { "type": "object", "required": [ "projectId" ], "properties": { "projectId": { "type": "string", "description": "Project id from list_projects" } }, "additionalProperties": false } ``` Tool: `get_prompt_results` Prompt-level answers from the latest completed audit: which AI tools mentioned the brand, at what rank, with which cited domains. Includes the verbatim answers. ```json { "type": "object", "required": [ "projectId" ], "properties": { "projectId": { "type": "string" }, "limit": { "type": "number", "description": "Max answers to return (default 25, max 200)" } }, "additionalProperties": false } ``` Tool: `get_actions` The action recommendations for a project (what to fix first), each backed by stored answers. ```json { "type": "object", "required": [ "projectId" ], "properties": { "projectId": { "type": "string" } }, "additionalProperties": false } ``` Claude Code ```bash claude mcp add --transport http recometrix https://recometrix.com/api/mcp --header "Authorization: Bearer rmx_YOUR_KEY" ``` JSON for other MCP clients ```json { "mcpServers": { "recometrix": { "url": "https://recometrix.com/api/mcp", "headers": { "Authorization": "Bearer rmx_YOUR_KEY" } } } } ``` ### Rate limits and errors Each active API key is limited to 600 requests per 60 seconds. When the limit is hit, the API returns `429` with `{ "error": "API rate limit exceeded. Try again in a minute." }` and `Retry-After: 60`. Missing, invalid, or revoked keys return `401`. Workspaces without API access return `403`. Unknown project IDs return `404` on REST and a tool error in MCP.