scan_for_mentionsScan platforms for brand mentions
What people said about something in the last day.
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
| Name | Type | Required | What it is |
|---|---|---|---|
topic | string | required | The brand, product, topic or person to look for, for example "Notion" or "AI note-taking". |
sources | list of string | optional | Optional. Only these places, by name (for example ["reddit", "hackernews"]). Left out, the default set is searched. |
hours_back | integer | optional, default 24 | How many hours back to look, 1 to 24. Default 24. |
What comes back
Top-level fields of the output schema the server publishes.
| Field | Type | What it is |
|---|---|---|
credits_charged | number | Credits this call took. 0 when nothing was charged. |
error | string | Present when the call could not do the work; says why and that nothing was charged where that is so. |
message | string | A plain note about the answer, for example why candidates were returned instead of a result. |
pricing_note | string | What this call cost and what a repeat costs. |
mentionfox_check | any | Present 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. |
ok | boolean | True when the scan ran. |
topic | string | What was searched for. |
sources_scanned | array | The places searched. |
mention_count | number | How many mentions came back. |
mentions | array | Each mention: where it was said, a link, the text, the sentiment and whether it sounds like someone about to buy. |
credits_charged_total | number | Credits this scan took in total. |
note | string | A note about the scan, for example a place that could not be searched. |
mentionfox_url | string | The 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.
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
- Cost per call: The credits the tool lists per call, times the price of a credit (a plan's monthly price divided by its monthly credits).
- Per month: The credits each tool costs times the number of calls you type, added up for the tools you choose.
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.
Building an AI agent?
- The FoxAPIs MCP server gives your agent every tool through one connection.
- Per-call pricing in credits: you pay for the calls your agent makes, with no seats.
- Free plan: 100 credits a month, no card, no monthly fee.