SpyFu MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

Read domain stats, competitors, keywords, rankings and ad history in SpyFu.

The publisher's own server: Ably MCP by usefulapi

Overview

AI-generated overview

Hosted SpyFu connector that lets an assistant read domain SEO/PPC stats, competitors, keywords, rankings and ad history.

What you can do
  • Look up domain stats: latest, per month, full history, or up to 20 domains in bulk
  • Find matching domains and top competitors, and compare keyword overlap between domains
  • Explore keywords: organic and paid keywords, outranking keywords, related ideas and keyword metrics
  • Inspect SERPs, top pages, ranking history, paid SERPs and ad history by domain or term
  • Check API usage and manage the subscription (usage status, upgrade, cancel, feature request)
When to use it
Useful for SEO and PPC research: sizing up a competitor, finding shared or outranking keywords, checking search volume and cost per click, or reviewing ad history. Suits marketers and analysts who already have a SpyFu account and want an assistant to query it without local setup.
Requirements
Remote MCP endpoint reached over HTTP; no local install. Sign-in is via OAuth, and on first connect you supply a SpyFu API ID and Secret Key from the SpyFu account settings. A usefulapi.io plan applies: free tier of 50 tool calls per month, or a paid Pro/Pro+ plan.
Before you install
SpyFu bills the account for each row returned, so large page sizes cost real money; ad history rows are especially costly. The server asks for your SpyFu API ID and Secret Key, which it stores per user. Meta tools can start a paid Stripe subscription or cancel it, and the free tier is capped at 50 calls per month. Read-only tools do not change data.

Installation

In SourceWeft

  1. Open SpyFu MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fspyfu/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

SpyFu MCP by usefulapi

Use your SpyFu account from Claude, Cursor, or any MCP client. Read domain stats, competitors, organic and paid keywords, rankings, top pages and ad history. Hosted, no local install: connect with your own credentials.

Live endpoint: https://spyfu.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://spyfu.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http spyfu https://spyfu.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "spyfu": {      "url": "https://spyfu.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your SpyFu credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/spyfu/

On first connect you provide a SpyFu API ID and a SpyFu Secret Key (SpyFu → Account Settings → API Usage). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
spyfu_get_domain_statsreadGet latest domain stats
spyfu_get_domain_stats_historyreadGet full domain stats history
spyfu_get_domain_stats_for_monthreadGet domain stats for one month
spyfu_get_bulk_domain_statsreadGet stats for several domains
spyfu_find_matching_domainsreadFind domains matching a keyword
spyfu_get_top_competitorsreadGet top competitors of a domain
spyfu_get_competing_keywordsreadGet keywords shared by domains
spyfu_get_seo_keywordsreadGet organic keywords of a domain
spyfu_get_outranking_keywordsreadGet keywords where a domain outranks another
spyfu_get_top_pagesreadGet top pages of a domain
spyfu_get_serp_analysisreadAnalyze the results page of a keyword
spyfu_get_ranking_historyreadGet ranking changes of a domain over time
spyfu_get_keyword_informationreadGet metrics for keywords
spyfu_get_related_keywordsreadGet related keywords
spyfu_get_ppc_keywordsreadGet paid keywords of a domain
spyfu_get_paid_serpsreadGet paid search results of a domain
spyfu_get_domain_ad_historyreadGet ad history of a domain
spyfu_get_term_ad_historyreadGet ad history of a keyword
spyfu_get_api_usagereadGet API usage for a month
spyfu_usage_statusmetaUsage status (free-tier meter)
spyfu_request_featuremetaRequest a missing feature
spyfu_upgrademetaUpgrade to Pro or Pro+
spyfu_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with spyfu_upgrade (it returns a Stripe Checkout link). Cancel any time with spyfu_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running spyfu_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/spyfu/README.md at commit 4046075

Tools

19

spyfu_get_domain_stats

Get latest domain stats

Latest SEO and PPC stats of a domain: monthly organic clicks, paid clicks, budget, ranking keywords, strength. Use past_n_months for more months. SpyFu bills the account for each row returned, so keep page_size small. API: GET domain_stats_api/v2/getLatestDomainStats.

Parametersdomainrequiredcountry_codepast_n_months

spyfu_get_domain_stats_history

Get full domain stats history

Monthly SEO and PPC stats of a domain for all months SpyFu has (many rows, billed per row). Prefer spyfu_get_domain_stats unless you need the full history. API: GET domain_stats_api/v2/getAllDomainStats.

Parametersdomainrequiredcountry_code

spyfu_get_domain_stats_for_month

Get domain stats for one month

SEO and PPC stats of a domain for one month (yyyy-mm). API: GET domain_stats_api/v2/getDomainStatsForExactDate.

Parametersmonthrequireddomainrequiredcountry_code

spyfu_get_bulk_domain_stats

Get stats for several domains

SEO and PPC stats for up to 20 domains in one call (comma-separated). By default only the latest month per domain. API: GET domain_stats_api/v2/getBulkDomainStats.

Parametersdomainsrequiredonly_latestcountry_code

spyfu_find_matching_domains

Find domains matching a keyword

Find domains that match a search phrase, with traffic, budget and strength figures. SpyFu bills the account for each row returned, so keep page_size small. API: GET domain_stats_api/v2/getMatchingDomains.

Parametersqueryrequiredsort_bypage_sizesort_ordercountry_codestarting_row

spyfu_get_top_competitors

Get top competitors of a domain

Top competitor domains by keyword overlap. channel: seo, ppc or combined. SpyFu bills the account for each row returned, so keep page_size small. API: GET competitors_api/v2/<channel>/getTopCompetitors.

Parametersdomainrequiredchannelsort_bypage_sizesort_ordercountry_codestarting_row

spyfu_get_competing_keywords

Get keywords shared by domains

Keywords that several domains rank or advertise for (overlap) or that only the first domain has (is_intersection false and exclude_domains set). channel: seo or ppc. SpyFu bills the account for each row returned, so keep page_size small. API: GET keyword_api/v2/kombat/getCompeting<Seo|Ppc>Keywords.

Parameterschannelsort_bypage_sizesort_ordercountry_codestarting_rowexclude_domainsinclude_domainsrequiredis_intersection

spyfu_get_seo_keywords

Get organic keywords of a domain

Organic keywords a domain ranks for, with rank, search volume, clicks and cost. search_type picks the view: MostValuable, NewlyRanked, GainedRanks, LostRanks, GainedClicks, LostClicks, JustMadeIt (reached top 10), JustFellOff (left top 10). SpyFu bills the account for each row returned, so keep page_size small. API: GET serp_api/v2/seo/getSeoKeywords.

Parametersdomainrequiredsort_bypage_sizesort_ordersearch_typecountry_codestarting_rowcompare_domain

spyfu_get_outranking_keywords

Get keywords where a domain outranks another

Organic keywords where domain ranks above compare_domain (search_type TheyOutrankYou) or where domain just passed compare_domain (TheyJustSurpassedYou). SpyFu bills the account for each row returned, so keep page_size small. API: GET serp_api/v2/seo/getOrganicOutrankingKeywords.

Parametersdomainrequiredpage_sizesort_ordersearch_typecountry_codestarting_rowcompare_domainrequired

spyfu_get_top_pages

Get top pages of a domain

Top organic pages of a domain by estimated traffic (search_type MostTraffic) or newly ranking pages (New). SpyFu bills the account for each row returned, so keep page_size small. API: GET serp_api/v2/seo/getTopPages.

Parametersdomainrequiredpage_sizesort_ordersearch_typecountry_codestarting_rowkeyword_filter

spyfu_get_serp_analysis

Analyze the results page of a keyword

The organic results (domains, ranks, traffic, strength) for one keyword. Returns up to 105 rows by default; set page_size low. API: GET serp_api/v2/seo/getSerpAnalysisKeywords.

Parameterskeywordrequiredpage_sizecountry_code

spyfu_get_ranking_history

Get ranking changes of a domain over time

Rank changes of a domain between two dates. query_type: MostValuable, FellFromTop10, MadeTheTop10, NewKeywords, NoLongerRanks, GainedRanks, LostRanks, GainedClicks, LostClicks. SpyFu bills the account for each row returned, so keep page_size small. API: GET organic_history_api/v2/historic/getHistoricRankingsForDomain.

Parametersdomainrequiredsort_byend_datepage_sizequery_typesort_orderstart_datecountry_codestarting_row

spyfu_get_keyword_information

Get metrics for keywords

Search volume, difficulty, cost per click and clicks for up to 20 given keywords. Billed per keyword row. API: GET keyword_api/v2/related/getKeywordInformation.

Parameterskeywordsrequiredcountry_code

spyfu_get_ppc_keywords

Get paid keywords of a domain

Keywords a domain buys ads for. kind: most_successful (default) or new. SpyFu bills the account for each row returned, so keep page_size small. API: GET keyword_api/v2/ppc/getMostSuccessful or getNewKeywords.

Parameterskinddomainrequiredsort_bypage_sizesort_ordercountry_codestarting_rowexclude_domain

spyfu_get_paid_serps

Get paid search results of a domain

Search result pages where a domain showed ads, with ad position and count. SpyFu bills the account for each row returned, so keep page_size small. API: GET serp_api/v2/ppc/getPaidSerps.

Parametersdomainrequiredsort_bypage_sizesort_ordercountry_codestarting_row

spyfu_get_domain_ad_history

Get ad history of a domain

Ads (copy, position, keywords) a domain ran in search results over time. Rows are costly (about $3 per 1000). SpyFu bills the account for each row returned, so keep page_size small. API: GET cloud_ad_history_api/v2/domain/getDomainAdHistory.

Parametersdomainrequiredsort_bypage_sizecountry_codestarting_rowkeyword_filter

spyfu_get_term_ad_history

Get ad history of a keyword

Ads that ran for one keyword over time, with the advertisers. Rows are costly (about $3 per 1000). SpyFu bills the account for each row returned, so keep page_size small. API: GET cloud_ad_history_api/v2/term/getTermAdHistory.

Parameterskeywordrequiredpage_sizecountry_codestarting_row

spyfu_get_api_usage

Get API usage for a month

Rows used and cost of the SpyFu API for a month (yyyy-mm), in total, by day or by method. API: GET accounts_api/v2/usage/month/{month}[/daily|/method].

Parametersmonthrequiredbreakdown

Version history

6
  1. v1.3.4LatestNov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations