---

name: exa-search
description: Use Exa MCP for current web, code/docs, company, people, and page-fetch research. Prefer current hosted tool schemas and note deprecated tools.

Exa MCP Search

Use this skill when online search, page fetch, code/docs lookup, company research, people research, or Exa MCP parameter checks are needed.

Current Source Of Truth

• Hosted MCP endpoint: https://mcp.exa.ai/mcp
• Official source: exa-labs/exa-mcp-server
• Current npm package checked: exa-mcp-server@3.2.1
• Tool schemas can change. Before adding new parameters, verify with:

mcporter list 'https://mcp.exa.ai/mcp?tools=web_search_exa,web_search_advanced_exa,web_fetch_exa' --schema

Tool Choice

Need	Prefer	Notes
General current web search	web_search_exa	Simple search. Only query and numResults.
Filtered search, dates, domains, categories, summaries, highlights, subpages	web_search_advanced_exa	Enable explicitly in tools=. Use this for company/people/papers/news filters.
Read known URLs fully	web_fetch_exa	Use after search when highlights are insufficient.
Code examples/docs	web_search_exa	get_code_context_exa still exists but is deprecated.
Company research	web_search_advanced_exa with category:"company"	company_research_exa still exists but is deprecated.
People/profiles	web_search_advanced_exa with category:"people"	people_search_exa still exists but is deprecated.

Core Parameters

web_search_exa

• query required: semantically rich natural-language query. Can include category:company or category:people.
• numResults optional: default 10.
• No type, livecrawl, contextMaxCharacters, or tokensNum on current hosted schema.

{"query":"latest AI safety research June 2026","numResults":10}

web_search_advanced_exa

• query required.
• Common optional filters: numResults, type (auto | fast | instant), category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate, startCrawlDate, endCrawlDate, includeText, excludeText, userLocation, moderation, additionalQueries.
• Content controls: textMaxCharacters, contextMaxCharacters, enableSummary, summaryQuery, enableHighlights, highlightsMaxCharacters, highlightsQuery, maxAgeHours, livecrawlTimeout, subpages, subpageTarget.
• Categories include company, research paper, news, pdf, github, personal site, people, financial report.

{
  "query":"Anthropic funding valuation 2026",
  "category":"news",
  "includeDomains":["techcrunch.com","bloomberg.com"],
  "startPublishedDate":"2026-01-01",
  "numResults":10,
  "type":"auto",
  "enableHighlights":true
}

web_fetch_exa

• urls required: array of URLs. A single string may also be accepted by the server.
• maxCharacters optional: default 3000.

{"urls":["https://docs.exa.ai/reference"],"maxCharacters":5000}

Deprecated But Still Available

• get_code_context_exa: use web_search_exa instead. Current schema is query, numResults; old tokensNum is obsolete.
• company_research_exa: use web_search_advanced_exa with category:"company" instead. Schema is companyName, numResults; default 3.
• people_search_exa: use web_search_advanced_exa with category:"people" instead.
• crawling_exa: use web_fetch_exa instead.
• deep_search_exa: use web_search_advanced_exa instead; may require user-provided Exa API key and may not register on anonymous hosted MCP.
• deep_researcher_start / deep_researcher_check: deprecated; use Exa Research API directly when needed.

Invocation Examples

URL="https://mcp.exa.ai/mcp?tools=web_search_exa,web_search_advanced_exa,web_fetch_exa"
npx -y mcporter call ".web_search_exa" query="latest AI safety research" numResults:=10
npx -y mcporter call ".web_search_advanced_exa" query="AI infrastructure startups" category=company numResults:=20
npx -y mcporter call ".web_fetch_exa" urls:='["https://docs.exa.ai/reference"]' maxCharacters:=5000

For mcporter call --http-url style, keep JSON args aligned with the same schemas.

Research Practice

• For simple lookup, run one targeted web_search_exa call.
• For dated/current questions, calculate exact date ranges first and pass startPublishedDate / endPublishedDate through web_search_advanced_exa.
• For source-heavy tasks, fetch only the best URLs with web_fetch_exa; do not dump raw results into the final answer.
• For company/people/paper/news workflows, prefer web_search_advanced_exa categories rather than deprecated specialized tools.
• Mention source uncertainty when Exa returns sparse, conflicting, or old results.

References

• Tool fields: references/exa-tools.md