Refine AIRefine Docs
MCP server

Tools reference

The Refine MCP server exposes 15 tools. In practice you won’t call them by hand — your assistant picks the right tool from these descriptions. Click any tool to see its parameters and what it returns.

How results come back

Every tool returns its payload as JSON inside the MCP content array (a single text item holding a JSON string). Your client parses this automatically — the shapes below describe the decoded JSON.

Example call

tools/call
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_visibility",
    "arguments": { "days": "30" }
  }
}

Example result

result
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      { "type": "text", "text": "{\"mention_rate\":0.42,\"average_rank\":3.1,…}" }
    ]
  }
}

All calls go to https://app.refine-app.com/api/mcp/mcp with your bearer token.

Analytics

Read-only insight into how AI search engines see your brand. Available on the Visibility plan and above.

Content generation

Generate publish-ready content from your prompts. Requires the Autopilot plan.

Prompts

Create, edit and remove the search prompts Refine monitors for your brand. Visibility plan and above.

Tags

Organize prompts with color-coded tags. Visibility plan and above.

Competitors

Track the competitors you want to benchmark against. Visibility plan and above.