# Serpfull AI connector

Connect AI apps and code editors to Serpfull over a remote MCP server (https://www.serpfull.com/api/mcp) with OAuth sign-in. You choose the websites and permissions (read, run actions, change settings); every request is checked and logged.

## Tools

- **Health and priorities** (Across every module): A one-call health overview of a website, and a ranked action plan of SEO, answer-engine, technical, link, trust and compliance fixes with the evidence behind each.
- **Rankings and competitors** (SERP clicks · Competitors): Search terms, run results and position history; competitor visibility and movements. Add keywords or competitors, or pause a term.
- **SEO and answer engines** (SEO audit): Pages, issues by severity and per-page audits compared with the competitors that outrank you. Start a fresh audit after a fix.
- **Backlinks** (Backlinks · Backlink exchange): Referring domains, links, lost links and the competitor link gap. Re-check a link live.
- **Visitors** (Analytics · Recordings): Traffic, sources, pages, goals and not-found pages; recordings summarised as pages, clicks, rage clicks and errors, with no personal data.
- **Reliability** (Uptime · Domain monitor): Monitors, incidents and status pages; domain, certificate and email-security health. Create a monitor or run a propagation check.
- **Compliance and protection** (Cookie consent · Bot protection): Banner status, scanned cookies and consent rates; bot traffic and rules. Rescan cookies, or add and remove bot rules with confirmation.
- **Reports** (Reports): List reports, generate a new one and create a share link for your team or client.

## Setup

### Claude

Open Settings → Connectors → Add custom connector. Name it Serpfull and paste the address below. Press Connect, sign in to Serpfull and choose websites and permissions.

```
https://www.serpfull.com/api/mcp
```

### ChatGPT

Open Settings → Apps & Connectors and turn on developer mode if your workspace needs it. Create a connector with the address below and OAuth sign-in. Sign in to Serpfull when asked and approve access.

```
https://www.serpfull.com/api/mcp
```

### Claude Code

Run this in your terminal, then type /mcp in Claude Code to sign in.

```
claude mcp add --transport http serpfull https://www.serpfull.com/api/mcp
```

### Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), then sign in from Settings → MCP.

```
{
  "mcpServers": {
    "serpfull": { "url": "https://www.serpfull.com/api/mcp" }
  }
}
```

### VS Code

Add this to .vscode/mcp.json, start the server from the file, and sign in when prompted.

```
{
  "servers": {
    "serpfull": { "type": "http", "url": "https://www.serpfull.com/api/mcp" }
  }
}
```

### Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json, refresh MCP servers and sign in.

```
{
  "mcpServers": {
    "serpfull": { "serverUrl": "https://www.serpfull.com/api/mcp" }
  }
}
```

## Limits

| Plan | Tool calls per website per month | Calls per minute |
|---|---|---|
| Starter | 2,000 | 20 |
| Growth | 10,000 | 30 |
| Scale | 40,000 | 60 |
| Pro | 100,000 | 90 |
| Business | 250,000 | 120 |
| Enterprise | 500,000 | 240 |

## FAQ

### Which AI apps can connect?

Any app or code editor that supports remote MCP connectors with sign-in, including Claude, ChatGPT, Claude Code, Cursor, VS Code and Windsurf. Setup steps for each are above.

### Can the assistant change things without asking?

Assistants can only use the permissions you grant on the consent screen. Removing anything needs an explicit confirmation, and well-behaved assistants ask you before running actions. Every request is logged.

### Will it see all my websites?

No. You tick the websites a connection can see. Every request is checked against that list on our servers, so data from other websites is never returned.

### Does it cost extra?

No. The connector is included on every plan, with a monthly allowance of tool calls per website. Actions such as audits or rescans use the same quotas as in the dashboard.

### Is my data used to train AI models?

Serpfull doesn't train models on your data. What your AI app does with the answers it receives is governed by that app's own terms and settings.

### How do I disconnect?

Go to Settings → AI connections and press Disconnect. Access stops immediately. You can also remove the connector in the AI app.