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@15ffb50519e719dc791cdc750ce5ed1934c0a1ed
- Current npm package checked:
exa-mcp-server@3.4.1; verified tarball SHA-256 62379fab5750cbc8334f096ff986ab1b7152488afffab5b0e275995310b6e978
- Tool schemas can change. Before adding new parameters, verify with
tools/list through a normal HTTP client.
Direct MCP HTTP is the required invocation model for this skill. curl is fine, but keep the session and SSE parsing in small shell helpers instead of repeating low-level flags at every call site.
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.
- Deprecated highlight controls:
highlightsNumSentences, highlightsPerUrl; prefer highlightsMaxCharacters.
- Categories include
company, publication, 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. Batch multiple URLs in one call.
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; current hosted MCP requires OAuth or an API key when this tool is requested.
deep_researcher_start / deep_researcher_check: deprecated; use Exa Research API directly when needed.
Curl Pattern
- POST
initialize; keep returned Mcp-Session-Id response header.
- POST
notifications/initialized with that header.
- POST
tools/list or tools/call with that header.
- If response is
text/event-stream, parse JSON from data: lines.
Minimal Curl Helper
EXA_URL="https://mcp.exa.ai/mcp?tools=web_search_exa,web_search_advanced_exa,web_fetch_exa"
EXA_SESSION_ID=""
exa_rpc() {
local payload="$1"
local session_header=()
local response
if [ -n "$EXA_SESSION_ID" ]; then
session_header=(-H "Mcp-Session-Id: $EXA_SESSION_ID")
fi
response="$(curl -isS "$EXA_URL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
"${session_header[@]}" \
--data "$payload")"
if [ -z "$EXA_SESSION_ID" ]; then
EXA_SESSION_ID="$(printf '%s\n' "$response" | awk 'tolower($0) ~ /^mcp-session-id:/ { sub(/^[^:]+:[[:space:]]*/, ""); gsub(/\r/, ""); print; exit }')"
fi
printf '%s\n' "$response" | sed -n 's/^data: //p'
}
exa_init() {
exa_rpc '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"exa-curl","version":"0.1.0"}}}' >/dev/null
exa_rpc '{"jsonrpc":"2.0","method":"notifications/initialized"}' >/dev/null
}
exa_call() {
local tool_name="$1"
local arguments_json="$2"
jq -nc --arg name "$tool_name" --argjson arguments "$arguments_json" \
'{jsonrpc:"2.0",id:2,method:"tools/call",params:{name:$name,arguments:$arguments}}' |
while IFS= read -r payload; do exa_rpc "$payload"; done
}
exa_init
exa_call web_search_exa '{"query":"latest AI safety research","numResults":5}'
Tool output format differs: web_search_exa returns formatted text, web_search_advanced_exa returns JSON text, and web_fetch_exa returns fetched page text.
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
1---
2name: exa-search
3description: Use Exa MCP for current web, code/docs, company, people, and page-fetch research. Prefer current hosted tool schemas and note deprecated tools.
4metadata:
5 source: https://skillmd.com/skills/mxyhi/exa-search
6---
7
8# Exa MCP Search
9
10Use this skill when online search, page fetch, code/docs lookup, company research, people research, or Exa MCP parameter checks are needed.
11
12## Current Source Of Truth
13
14- Hosted MCP endpoint: `https://mcp.exa.ai/mcp`
15- Official source: `exa-labs/exa-mcp-server@15ffb50519e719dc791cdc750ce5ed1934c0a1ed`
16- Current npm package checked: `exa-mcp-server@3.4.1`; verified tarball SHA-256 `62379fab5750cbc8334f096ff986ab1b7152488afffab5b0e275995310b6e978`
17- Tool schemas can change. Before adding new parameters, verify with `tools/list` through a normal HTTP client.
18
19Direct MCP HTTP is the required invocation model for this skill. `curl` is fine, but keep the session and SSE parsing in small shell helpers instead of repeating low-level flags at every call site.
20
21## Tool Choice
22
23| Need | Prefer | Notes |
24| --- | --- | --- |
25| General current web search | `web_search_exa` | Simple search. Only `query` and `numResults`. |
26| Filtered search, dates, domains, categories, summaries, highlights, subpages | `web_search_advanced_exa` | Enable explicitly in `tools=`. Use this for company/people/papers/news filters. |
27| Read known URLs fully | `web_fetch_exa` | Use after search when highlights are insufficient. |
28| Code examples/docs | `web_search_exa` | `get_code_context_exa` still exists but is deprecated. |
29| Company research | `web_search_advanced_exa` with `category:"company"` | `company_research_exa` still exists but is deprecated. |
30| People/profiles | `web_search_advanced_exa` with `category:"people"` | `people_search_exa` still exists but is deprecated. |
31
32## Core Parameters
33
34### `web_search_exa`
35
36- `query` required: semantically rich natural-language query. Can include `category:company` or `category:people`.
37- `numResults` optional: default `10`.
38- No `type`, `livecrawl`, `contextMaxCharacters`, or `tokensNum` on current hosted schema.
39
40```json
41{"query":"latest AI safety research June 2026","numResults":10}
42```
43
44### `web_search_advanced_exa`
45
46- `query` required.
47- Common optional filters: `numResults`, `type` (`auto` | `fast` | `instant`), `category`, `includeDomains`, `excludeDomains`, `startPublishedDate`, `endPublishedDate`, `startCrawlDate`, `endCrawlDate`, `includeText`, `excludeText`, `userLocation`, `moderation`, `additionalQueries`.
48- Content controls: `textMaxCharacters`, `contextMaxCharacters`, `enableSummary`, `summaryQuery`, `enableHighlights`, `highlightsMaxCharacters`, `highlightsQuery`, `maxAgeHours`, `livecrawlTimeout`, `subpages`, `subpageTarget`.
49- Deprecated highlight controls: `highlightsNumSentences`, `highlightsPerUrl`; prefer `highlightsMaxCharacters`.
50- Categories include `company`, `publication`, `news`, `pdf`, `github`, `personal site`, `people`, `financial report`.
51
52```json
53{
54 "query":"Anthropic funding valuation 2026",
55 "category":"news",
56 "includeDomains":["techcrunch.com","bloomberg.com"],
57 "startPublishedDate":"2026-01-01",
58 "numResults":10,
59 "type":"auto",
60 "enableHighlights":true
61}
62```
63
64### `web_fetch_exa`
65
66- `urls` required: array of URLs. Batch multiple URLs in one call.
67- `maxCharacters` optional: default `3000`.
68
69```json
70{"urls":["https://docs.exa.ai/reference"],"maxCharacters":5000}
71```
72
73### Deprecated But Still Available
74
75- `get_code_context_exa`: use `web_search_exa` instead. Current schema is `query`, `numResults`; old `tokensNum` is obsolete.
76- `company_research_exa`: use `web_search_advanced_exa` with `category:"company"` instead. Schema is `companyName`, `numResults`; default `3`.
77- `people_search_exa`: use `web_search_advanced_exa` with `category:"people"` instead.
78- `crawling_exa`: use `web_fetch_exa` instead.
79- `deep_search_exa`: use `web_search_advanced_exa` instead; current hosted MCP requires OAuth or an API key when this tool is requested.
80- `deep_researcher_start` / `deep_researcher_check`: deprecated; use Exa Research API directly when needed.
81
82## Curl Pattern
83
841. POST `initialize`; keep returned `Mcp-Session-Id` response header.
852. POST `notifications/initialized` with that header.
863. POST `tools/list` or `tools/call` with that header.
874. If response is `text/event-stream`, parse JSON from `data:` lines.
88
89### Minimal Curl Helper
90
91```bash
92EXA_URL="https://mcp.exa.ai/mcp?tools=web_search_exa,web_search_advanced_exa,web_fetch_exa"
93EXA_SESSION_ID=""
94
95exa_rpc() {
96 local payload="$1"
97 local session_header=()
98 local response
99
100 if [ -n "$EXA_SESSION_ID" ]; then
101 session_header=(-H "Mcp-Session-Id: $EXA_SESSION_ID")
102 fi
103
104 response="$(curl -isS "$EXA_URL" \
105 -H 'Content-Type: application/json' \
106 -H 'Accept: application/json, text/event-stream' \
107 "${session_header[@]}" \
108 --data "$payload")"
109
110 if [ -z "$EXA_SESSION_ID" ]; then
111 EXA_SESSION_ID="$(printf '%s\n' "$response" | awk 'tolower($0) ~ /^mcp-session-id:/ { sub(/^[^:]+:[[:space:]]*/, ""); gsub(/\r/, ""); print; exit }')"
112 fi
113
114 printf '%s\n' "$response" | sed -n 's/^data: //p'
115}
116
117exa_init() {
118 exa_rpc '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"exa-curl","version":"0.1.0"}}}' >/dev/null
119 exa_rpc '{"jsonrpc":"2.0","method":"notifications/initialized"}' >/dev/null
120}
121
122exa_call() {
123 local tool_name="$1"
124 local arguments_json="$2"
125 jq -nc --arg name "$tool_name" --argjson arguments "$arguments_json" \
126 '{jsonrpc:"2.0",id:2,method:"tools/call",params:{name:$name,arguments:$arguments}}' |
127 while IFS= read -r payload; do exa_rpc "$payload"; done
128}
129
130exa_init
131exa_call web_search_exa '{"query":"latest AI safety research","numResults":5}'
132```
133
134Tool output format differs: `web_search_exa` returns formatted text, `web_search_advanced_exa` returns JSON text, and `web_fetch_exa` returns fetched page text.
135
136## Research Practice
137
138- For simple lookup, run one targeted `web_search_exa` call.
139- For dated/current questions, calculate exact date ranges first and pass `startPublishedDate` / `endPublishedDate` through `web_search_advanced_exa`.
140- For source-heavy tasks, fetch only the best URLs with `web_fetch_exa`; do not dump raw results into the final answer.
141- For company/people/paper/news workflows, prefer `web_search_advanced_exa` categories rather than deprecated specialized tools.
142- Mention source uncertainty when Exa returns sparse, conflicting, or old results.
143
144## References
145
146- Tool fields: `references/exa-tools.md`