Skip to content
MCP server

refd

Read AI search visibility, competitors and citations, and manage tracked prompts

Install
Pricing
Freemium
Platforms
API, Web, self-hosted
Runs
Remotely
Version
0.3.0
Listing updated
1 day ago

About refd

refd is a freemium MCP server for marketing and seo. It runs as a hosted remote server, so there is nothing to install locally.

refd is open-source AI search monitoring. It tracks how a brand appears in answers from ChatGPT, Perplexity, Gemini, Google AI Mode and Google AI Overviews, scoring each answer for every tracked entity as mentioned, cited and first-mention position. This connector lets an assistant read that workspace data: visibility, competitors and citations.

The default data:read scope is read-only. An optional data:write scope adds the bounded setup lifecycle, can start one onboarding report, and can revoke the connection with explicit confirmation. Prompt management is part of the set. OAuth is used for interactive clients and personal access tokens for headless agents.

Under the hood, a workspace tracks one brand with its competitors and prompt set. A daily cron runs the prompts, scraping through BrightData and keeping raw payloads in R2. You can use the hosted app or self-host the Cloudflare Workers stack. Standard accounts get up to five workspaces and 25 active prompts each.

Install

Run in a terminal

claude mcp add --transport http refd https://api.refd.ai/mcp

Add to Settings → Connectors → Add custom connector

https://api.refd.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "refd": {
      "url": "https://api.refd.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "refd": {
      "type": "http",
      "url": "https://api.refd.ai/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "refd": {
      "serverUrl": "https://api.refd.ai/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "refd": {
      "type": "http",
      "url": "https://api.refd.ai/mcp"
    }
  }
}

What it does

Visibility reads
Read where a brand appears in AI answers and with what score.
Competitor and citation data
See who appears instead and which sources are cited.
Prompt management
Manage tracked prompts when write access is granted.
Scoped access
Read-only by default, with an optional write scope.
Five AI engines
Covers ChatGPT, Perplexity, Gemini, Google AI Mode and AI Overviews.
Self-hostable
The whole stack can be run on your own Cloudflare account.

Good for

  • Check whether a brand is mentioned in AI answers
  • See which competitors appear for tracked prompts
  • Find the sources AI engines cite
  • Add or retire tracked prompts from chat

Pricing

Freemium

Hosted app and self-hosting available; prices not published

Prices change. Check refd.ai before you buy.

refd FAQ

Is it open source?

Yes, the project can be self-hosted.

What access does the default connection give?

Read-only through the data:read scope.

How do headless agents authenticate?

With a personal access token from Settings.

Which engines are monitored?

ChatGPT, Perplexity, Gemini, Google AI Mode and Google AI Overviews.

Is refd free?

refd has a free plan, with paid plans for more usage or features.

How do I add refd to Claude Code?

Run this command in your terminal: claude mcp add --transport http refd https://api.refd.ai/mcp

What are the best alternatives to refd?

The closest alternatives to refd are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to refd

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data