enrich_personPerson's contact details
How to reach one person: their email address, phone number where there is one, and their profile links.
What it does
How to reach one person: their email address, phone number where there is one, and their profile links. Give a name — add their employer if the name is a common one — and you get back the person, their current role, and the ways to contact them. Use it when someone says "how do I get hold of her", "find his email", "I need to reach the person who runs marketing there". Do not use it to find out WHO to contact: this looks up somebody you can already name. If the name matches more than one person you get the list of candidates and nothing is charged; pick one and ask again. Nothing is charged when nobody matches either. Costs 5 credits when it finds them. 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 |
|---|---|---|---|
name | string | optional | The full name of the person, for example "Jane Doe". Give either name or person_id. |
person_id | string | optional | The id of one person from the candidate list an earlier call returned, when the name matched several people. Give either name or person_id. |
company | string | optional | Optional. Where they work, as a name or website (for example "Acme" or acme.com), so a common name finds the right person. |
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. |
status | string | "needs_disambiguation" when the name matched more than one person; pick one and call again with its person_id. |
candidates | array | People or companies the name could mean, each with an id and enough to tell them apart. Nothing is charged for this list. |
retry_with_param | string | The input to send on the next call with the chosen candidate. |
full_name | string | The person found. |
title | string | Their current role. |
company | string | Where they work now. |
location | string | Where they are based. |
photo_url | string | A link to their photo. |
emails | array | Email addresses that are confirmed or published, each with its status. |
phones | array | Phone numbers, where there are any. |
linkedin_url | string | Their professional profile link. |
twitter_handle | string | Their X handle. |
github_handle | string | Their code-hosting handle. |
summary | string | A one-paragraph summary of who they are. |
mentionfox_url | string | Their page 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": "enrich_person",
"arguments": {
"name": "Jane Example",
"company": "example.com"
}
}
}
Example answer
This tool looks up contact details for a named person. We do not publish a real person's contact details as a demo, so no output is shown here. The fields it returns are listed above from the server's own output schema.
Credits for your use
Calculated by us from the price above (5 per person found).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 · get_snapshot · get_full_report · get_dossier · compare_people · scan_for_mentions · 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.