The Refine MCP server
Refine AI tracks how your brand shows up in AI search engines. The Refine MCP server hands that data — and the controls behind it — straight to your AI assistant. Ask Claude how your visibility moved this week, have it draft a blog post from your top prompt, or let it manage the competitors you benchmark against. All without leaving the chat.
What’s newA complete reference, and this page · The docs now cover the whole server: all 31 tools with their defaults, return shapes and exact error messages, plus two new guides.New to MCP?
The Model Context Protocol is an open standard that lets AI assistants securely connect to external tools and data. Refine exposes a remote MCP server, so any MCP-compatible client can talk to your Refine workspace once you give it an API key.Quickstart
Connect Refine to Claude or Cursor in under five minutes.
Tools reference
All 31 tools, with parameters and return shapes.
What you can do
The server exposes 31 tools across 9 areas:
Read your visibility
Pull mention rate, average rank and per-day history across ChatGPT, Gemini, Perplexity and more.
Find what to fix
Rank prompts by the search demand you miss, suggest new ones, and read the pages AI engines cite instead of you.
Tie it to traffic
Read Search Console and GA4 data for the brand to connect AI visibility with clicks and sessions.
Manage prompts
Create, edit and remove the search prompts Refine monitors for your brand.
Track competitors
Add and benchmark competitors, and see how their AI visibility stacks up against yours.
Generate content
Spin up blog articles, Reddit responses and LinkedIn posts grounded in your prompts.
Publish on your site
Send articles to WordPress, Webflow or a Next.js site, by hand or with an agent on a schedule.
Organize with tags
Group and color-code prompts so your assistant can reason about themes.
Plug into any client
A standard Streamable HTTP MCP server: Claude, ChatGPT, Cursor, Hermes and the rest.
How it works
The server speaks the Streamable HTTP MCP transport. Your client opens a connection to a single endpoint and authenticates with a personal API key sent as a bearer token:
You generate an API key tied to one brand in your Refine workspace.
Your client connects to https://app.refine-app.com/api/mcp/mcp with Authorization: Bearer rfn_live_….
Every tool call is automatically scoped to that brand — no way to reach another workspace’s data.
You’ll need a paid plan
MCP tools are gated by subscription. Analytics, opportunities, Google data, prompts, tags and competitors work on any paid plan; content generation and publishing require the Autopilot plan. See Authentication for details.