Docs
The API.
Your visibility data, without the dashboard.
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. |
GET /api/v1/projects
{
"projects": [
{
"id": "6f0c9f0e-2a9d-4b5f-8c1a-2b3c4d5e6f70",
"brandName": "AcmeDesk",
"websiteUrl": "https://acmedesk.example",
"category": "shared inbox software"
}
]
}GET /api/v1/projects/{projectId}/metrics
{
"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
}
]
}GET /api/v1/projects/{projectId}/answers
{
"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.
list_projects
List the brands/projects tracked in this Recometrix workspace, with their ids.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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.
{
"type": "object",
"required": [
"projectId"
],
"properties": {
"projectId": {
"type": "string",
"description": "Project id from list_projects"
}
},
"additionalProperties": false
}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.
{
"type": "object",
"required": [
"projectId"
],
"properties": {
"projectId": {
"type": "string"
},
"limit": {
"type": "number",
"description": "Max answers to return (default 25, max 200)"
}
},
"additionalProperties": false
}get_actions
The action recommendations for a project (what to fix first), each backed by stored answers.
{
"type": "object",
"required": [
"projectId"
],
"properties": {
"projectId": {
"type": "string"
}
},
"additionalProperties": false
}Claude Code
claude mcp add --transport http recometrix https://recometrix.com/api/mcp --header "Authorization: Bearer rmx_YOUR_KEY"JSON for other MCP clients
{"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.