# refd

> refd is a freemium MCP server for marketing and seo. Read AI search visibility, competitors and citations, and manage tracked prompts. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web, self-hosted
- **Website:** https://refd.ai
- **Repository:** https://github.com/emaitchess/refd
- **MCP Registry name:** ai.refd/refd
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.refd.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "refd": {
      "url": "https://api.refd.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/refd
