# SpyFu MCP by usefulapi

> SpyFu MCP by usefulapi is a freemium MCP server for marketing and seo. Hosted MCP connector that lets AI assistants query SpyFu SEO and PPC data for SEO. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API, vscode
- **Website:** https://usefulapi.io/spyfu/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/spyfu
- **MCP Registry name:** io.usefulapi/spyfu
- **Categories:** marketing and SEO
- **Listing updated:** 2026-11-18

## About

The README describes a hosted remote server rather than a local install, so you add one URL to an MCP-capable client and sign in with your own SpyFu API credentials. Once connected, the assistant can call 23 tools that read SpyFu data such as domain stats, top competitors, organic and paid keywords, ranking changes, top pages and ad history.

The tools are split into 19 read-only lookups and four account tools for checking usage, upgrading or cancelling a subscription, and sending feature requests. Each lookup maps to a SpyFu API endpoint, and the page notes that SpyFu bills API usage per row returned, so results are kept to small pages by default.

The server suits SEO and paid search marketers who already hold a SpyFu API plan and want to ask competitor and keyword questions in plain language from Claude, ChatGPT, Cursor, VS Code or Codex. Access requires SpyFu API access on a Pro + AI or Team/Agency plan, and the service is operated by usefulapi, which states it is not affiliated with SpyFu.

## Features

- **Competitor discovery:** Lists a domain's top competitors by SEO or PPC keyword overlap.
- **Keyword gap analysis:** Finds keywords shared with rivals or where one domain outranks another.
- **Domain stats history:** Returns monthly organic and paid stats and ranking changes over time.
- **Ad history lookup:** Shows the ads a domain or keyword has run, with positions and advertisers.
- **Keyword metrics and ideas:** Reports search volume, difficulty and cost per click, plus related keyword suggestions.
- **Usage and plan tools:** Checks monthly usage and handles upgrade or cancellation of the Pro subscription.

## Good for

- Compare organic keyword overlap between your site and its main competitors
- Find keywords a rival ranks for that your domain does not
- Review which paid keywords and ads a competitor has been running
- Check search volume and cost per click for a shortlist of keywords
- Track how a domain's rankings and traffic changed over several months

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http spyfu https://spyfu.usefulapi.io/mcp
```

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

```sh
https://spyfu.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "spyfu": {
      "url": "https://spyfu.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "spyfu": {
      "type": "http",
      "url": "https://spyfu.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "spyfu": {
      "serverUrl": "https://spyfu.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "spyfu": {
      "type": "http",
      "url": "https://spyfu.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `spyfu_get_domain_stats`: Latest SEO and PPC stats of a domain.
- `spyfu_get_domain_stats_history`: Monthly SEO and PPC stats of a domain for all months SpyFu has.
- `spyfu_get_domain_stats_for_month`: SEO and PPC stats of a domain for one month.
- `spyfu_get_bulk_domain_stats`: SEO and PPC stats for up to 20 domains in one call.
- `spyfu_find_matching_domains`: Find domains that match a search phrase.
- `spyfu_get_top_competitors`: Top competitor domains by keyword overlap.
- `spyfu_get_competing_keywords`: Keywords that several domains rank or advertise for.
- `spyfu_get_seo_keywords`: Organic keywords a domain ranks for.
- `spyfu_get_outranking_keywords`: Organic keywords where a domain outranks another domain.
- `spyfu_get_top_pages`: Top organic pages of a domain.
- `spyfu_get_serp_analysis`: Organic results for one keyword.
- `spyfu_get_ranking_history`: Rank changes of a domain between two dates.
- `spyfu_get_keyword_information`: Search volume, difficulty, cost per click and clicks for keywords.
- `spyfu_get_related_keywords`: Keyword ideas for a seed keyword.
- `spyfu_get_ppc_keywords`: Keywords a domain buys ads for.
- `spyfu_get_paid_serps`: Search result pages where a domain showed ads.
- `spyfu_get_domain_ad_history`: Ads a domain ran in search results over time.
- `spyfu_get_term_ad_history`: Ads that ran for one keyword over time.
- `spyfu_get_api_usage`: Rows used and cost of the SpyFu API for a month.
- `spyfu_usage_status`: Current usage against the plan limit.
- `spyfu_request_feature`: Send a request for a missing feature.
- `spyfu_upgrade`: Get a paid plan for SpyFu.
- `spyfu_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official SpyFu product?

No. The site says usefulapi is an independent service and is not affiliated with or endorsed by SpyFu.

### What do I need to connect?

The login page asks for a SpyFu API ID and SpyFu Secret Key, which are found under Account Settings and API Usage in SpyFu. API access needs a Pro + AI or Team/Agency plan.

### Can the AI change my SpyFu data?

The site states that all 19 SpyFu tools are marked read-only.

### What does it cost?

The free plan allows 50 tool calls a month. Pro is $9 per month or $90 per year for 10,000 calls, and Pro+ is $39 per month or $390 per year for 100,000 calls.

### Is SpyFu MCP by usefulapi free?

SpyFu MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add SpyFu MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http spyfu https://spyfu.usefulapi.io/mcp

### What are the best alternatives to SpyFu MCP by usefulapi?

The closest alternatives to SpyFu MCP by usefulapi are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Snapchat Ads MCP Server, MCP and Red Center Studio free tools.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [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.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Snapchat Ads MCP Server](https://ai-powered.com/mcp/snapchat-ads-mcp-server): Snapchat Ads MCP Server is an open-source MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/spyfu-mcp-by-usefulapi
