Home · MCP server · scan_for_mentions

scan_for_mentionsScan platforms for brand mentions

What people said about something in the last day.

Price per call. 3 credits per place scanned. 3 credits for each place it looks (a default run of five places is about 15).

Endpoint. https://foxapis.com/mcp (Streamable HTTP, protocol 2025-03-26)

Read-only. Yes: the server marks it read-only. Repeat call gives the same result. Not marked. Read from the live server: 19 November 2026.

What it does

What people said about something in the last day. Name a brand, a product, a topic or a person and this comes back with the posts, comments, articles and videos that mention it — each one with where it was said, a link to it, and whether it read as positive, negative or neither. It also marks the ones that sound like somebody about to buy, so this is the tool for "who is asking for something like ours". Use it for "what are people saying about us today", "did anyone pick up the launch", "anything new on this topic this week". It looks across 55 places by default and you can narrow that. It does not build a picture of a person — for that, ask for a brief. Costs 3 credits for each place it looks, so a default run of five places is about 15. If you name a company MentionFox holds a record for, the answer starts with the MentionFox check on it: red flags found, in how many sources, with a link to the full findings. Plans and credits: https://mentionfox.com/pricing

Inputs

NameTypeRequiredWhat it is
topicstringrequiredThe brand, product, topic or person to look for, for example "Notion" or "AI note-taking".
sourceslist of stringoptionalOptional. Only these places, by name (for example ["reddit", "hackernews"]). Left out, the default set is searched.
hours_backintegeroptional, default 24How many hours back to look, 1 to 24. Default 24.

What comes back

Top-level fields of the output schema the server publishes.

FieldTypeWhat it is
credits_chargednumberCredits this call took. 0 when nothing was charged.
errorstringPresent when the call could not do the work; says why and that nothing was charged where that is so.
messagestringA plain note about the answer, for example why candidates were returned instead of a result.
pricing_notestringWhat this call cost and what a repeat costs.
mentionfox_checkanyPresent when the call named a company MentionFox holds a record for: MentionFox's own check on it (the sentence, red flags and notes with their source links, how many sources) and a link to the full findings.
okbooleanTrue when the scan ran.
topicstringWhat was searched for.
sources_scannedarrayThe places searched.
mention_countnumberHow many mentions came back.
mentionsarrayEach mention: where it was said, a link, the text, the sentiment and whether it sounds like someone about to buy.
credits_charged_totalnumberCredits this scan took in total.
notestringA note about the scan, for example a place that could not be searched.
mentionfox_urlstringThe scan in MentionFox.

The request

An example request body; the values are made-up placeholders unless the next section shows the real call.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "scan_for_mentions",
    "arguments": {
      "topic": "Model Context Protocol",
      "sources": [
        "hackernews"
      ],
      "hours_back": 24
    }
  }
}

A real call and its answer

Run on 19 November 2026. Run on 19 November 2026 through the MentionFox connector, which talks to the same server that answers at https://foxapis.com/mcp. This was before the server accepted FoxAPIs keys (it does now: see the key note above), so these three runs spent MentionFox credits. A place that is scanned and returns nothing is still charged: 3 credits here. A second run on 'MCP server' (same place) also returned no mentions and charged 3 again.

Arguments sent

{
  "topic": "Model Context Protocol",
  "sources": [
    "hackernews"
  ],
  "hours_back": 24
}

Answer (3 credits on the first call)

{
  "topic": "Model Context Protocol",
  "sources_scanned": [
    "hackernews"
  ],
  "credits_charged_total": 3,
  "mention_count": 0,
  "mentions": [],
  "note": "No fresh mentions in the last 24h. Try a broader topic or run a deep scan from the dashboard.",
  "mentionfox_url": "https://mentionfox.com/dashboard/scans",
  "pricing_note": "3 credits per source (Quick Scan only via connector)."
}

Credits for your use

Calculated by us from the price above (3 per place scanned).Formula Where the tool states a condition (such as nothing charged when nothing is found), the real bill can be lower. Plans and credits: pricing.

Add the server to your editor

Install snippets for Claude Code, Cursor, VS Code, Cline, Zed and Windsurf, each with its checked date and a link to the client's own docs, are on the MCP server page.

Key: use your FoxAPIs API key (it starts with fxp_) as the bearer token. Calls spend your FoxAPIs credits, the same balance as the REST API, and each one shows in your credit ledger. A MentionFox personal key (mf_pat_...) also works and spends MentionFox credits. Tested 19 November 2026: a FoxAPIs key was accepted, and one tool call took one credit from the FoxAPIs balance.

Get a key and credits

The other tools

source_check · enrich_person · get_snapshot · get_full_report · get_dossier · compare_people · export_report · get_my_recent_research · find_buyers_now

Tool text, schemas and prices are read from the server and can change; this page shows what it said on 19 November 2026. Source: https://foxapis.com/mcp (tools/list).

How we calculate

Data: the FoxAPIs MCP tool list and plans, read 19 November 2026. Every other figure on this page is copied from the record, not calculated by us.

Run this free, then pay per call

Free to start: 100 credits, no card. Then from $10. Credits you buy never expire. Use them at your own pace. Get my free key

One call costs 1 credit. That is $7.96 per 1,000 calls on the Production plan and $9.80 on Builder (plan price divided by its monthly credits). The Free plan gives 100 credits a month with no card.

Run this freeBuy credits

Building an AI agent?

See the MCP server