mxyhi/ok-skills / exa-search
exa-search
VerifiedUse Exa MCP for current web, code/docs, company, people, and page-fetch research. Prefer current hosted tool schemas and note deprecated tools.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.4 KB |
| references/exa-tools.md | markdown | 8.7 KB |
references/exa-tools.md
View on GitHub# Exa MCP Tools And Parameters
Snapshot checked against:
- Hosted endpoint: `https://mcp.exa.ai/mcp`
- Official repo: `exa-labs/exa-mcp-server@15ffb50519e719dc791cdc750ce5ed1934c0a1ed`
- npm package: `exa-mcp-server@3.4.1`
- npm tarball SHA-256: `62379fab5750cbc8334f096ff986ab1b7152488afffab5b0e275995310b6e978`
- npm package `gitHead`: `66bacbe4afd35a7e1671be9ab55c2b6bf60aff34`
- Date checked: 2026-09-04
## Base URL
- Base: `https://mcp.exa.ai/mcp`
- Select tools: `?tools=tool_a,tool_b,...`
- API key: `?exaApiKey=YOUR_EXA_API_KEY`, `Authorization: Bearer ...`, or `EXA_API_KEY` for local npm.
- Anonymous hosted use works but has rate limits and may not register API-key-only tools.
- Streamable HTTP flow: `initialize`, `notifications/initialized`, then `tools/list` or `tools/call` with the returned `Mcp-Session-Id`.
- Hosted responses usually use `text/event-stream`; extract JSON from `data:` lines before parsing.
- Use `curl` through small shell helpers. Repeating raw header/body plumbing at every call site is noisy.
## Enabled By Default
| Tool | Purpose | Parameters |
| --- | --- | --- |
| `web_search_exa` | General web search with clean highlights/text | `query` required; `numResults` optional, default `10` |
| `web_fetch_exa` | Fetch full content for known URLs | `urls` required; `maxCharacters` optional, default `3000` |
## Off By Default
| Tool | Purpose | Parameters |
| --- | --- | --- |
| `web_search_advanced_exa` | Advanced search with filters and content controls | See detailed schema below |
## Deprecated Tools
| Tool | Use Instead | Current Parameters |
| --- | --- | --- |
| `get_code_context_exa` | `web_search_exa` | `query`, `numResults` |
| `company_research_exa` | `web_search_advanced_exa` with `category:"company"` | `companyName`, `numResults`; default `3` |
| `people_search_exa` | `web_search_advanced_exa` with `category:"people"` | `query`, `numResults`; default `5` |
| `crawling_exa` | `web_fetch_exa` | `urls`, `maxCharacters` |
| `linkedin_search_exa` | `web_search_advanced_exa` with `category:"people"` | `query`, `numResults` |
| `deep_search_exa` | `web_search_advanced_exa` | Requires OAuth or a user-provided API key on current hosted MCP when requested |
| `deep_researcher_start` | Exa Research API | `instructions`, `model`, `outputSchema` |
| `deep_researcher_check` | Exa Research API | `researchId` |
## `web_search_advanced_exa` Schema
Required:
- `query`: string
Optional:
- Search tuning: `numResults`, `type` (`auto` | `fast` | `instant`)
- Category: `company`, `publication`, `news`, `pdf`, `github`, `personal site`, `people`, `financial report`
- Domain filters: `includeDomains`, `excludeDomains`
- Date filters: `startPublishedDate`, `endPublishedDate`, `startCrawlDate`, `endCrawlDate`
- Text filters: `includeText`, `excludeText`
- Geo/safety: `userLocation`, `moderation`
- Query expansion: `additionalQueries`
- Content: `textMaxCharacters`, `contextMaxCharacters`, `enableSummary`, `summaryQuery`, `enableHighlights`, `highlightsMaxCharacters`, `highlightsNumSentences`, `highlightsPerUrl`, `highlightsQuery`
- Freshness/fetch: `maxAgeHours`, `livecrawlTimeout`
- Subpages: `subpages`, `subpageTarget`
Deprecated/compat details:
- `highlightsNumSentences` and `highlightsPerUrl` are deprecated in official source comments; prefer `highlightsMaxCharacters`.
- `livecrawl` is not a direct exposed parameter on current hosted `web_search_exa`; use advanced freshness controls (`maxAgeHours`, `livecrawlTimeout`) when needed.
- Old local docs mentioning `tokensNum` for `get_code_context_exa` are obsolete.
## Minimal MCP Schema Check
```bash
EXA_URL="https://mcp.exa.ai/mcp?tools=web_search_exa,web_search_advanced_exa,web_fetch_exa,get_code_context_exa,company_research_exa,people_search_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_rpc '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"exa-schema-check","version":"0.1.0"}}}' >/dev/null
exa_rpc '{"jsonrpc":"2.0","method":"notifications/initialized"}' >/dev/null
exa_rpc '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
```
Expected hosted anonymous tools from that request on 2026-06-23:
- `web_search_exa`
- `web_search_advanced_exa`
- `company_research_exa`
- `web_fetch_exa`
- `people_search_exa`
- `get_code_context_exa`
`deep_search_exa` was requested separately but did not register anonymously, matching official source behavior that requires a user-provided API key.
Rechecked on 2026-06-28 with `deep_search_exa` included in `tools=`:
- Returned HTTP 401 with `Authentication required. Use OAuth or provide an API key.`
- Without `deep_search_exa`, anonymous hosted MCP still returns `web_search_exa`, `web_search_advanced_exa`, `web_fetch_exa`, and requested deprecated tools.
- npm package `exa-mcp-server@3.2.1` confirms `deep_search_exa` only registers when a user-provided API key is present.
- `web_search_advanced_exa` still exposes deprecated `highlightsNumSentences` and `highlightsPerUrl`; prefer `highlightsMaxCharacters`.
Rechecked on 2026-07-06:
- Official repo `main` is `8823cbea80b6ec5999c6217cccd91660fe953b97`.
- npm latest remains `exa-mcp-server@3.2.1`, package `gitHead` remains `74438bc48ea9853e2e3e56f72535edc4f5c34bf6`, and tarball SHA-256 remains `675688dffcd746b8bb6ac7f077b64b7382c4a305f948d44ba526e67be50396df`.
- Anonymous hosted schema still returns `web_search_exa`, `web_search_advanced_exa`, `company_research_exa`, `web_fetch_exa`, `people_search_exa`, and `get_code_context_exa` with the same parameter surface.
- Requesting only `deep_search_exa` still returns HTTP 401 `Authentication required. Use OAuth or provide an API key.`
## Direct HTTP Smoke Result
No-proxy direct HTTP passed on 2026-06-23:
- `initialize`: protocol `2025-06-18`, server `exa-search-server`, version `3.2.1`
- `tools/list`: returned `web_search_exa`, `web_search_advanced_exa`, `web_fetch_exa`
- `tools/call web_search_exa`: returned `isError=false` and formatted search text
- `tools/call web_search_advanced_exa`: returned `isError=false` and JSON text
- `tools/call web_fetch_exa`: returned `isError=false` and fetched page text
Rechecked on 2026-07-15:
- Official repo `main` advanced to `8823cbea80b6ec5999c6217cccd91660fe953b97`.
- npm latest remains `exa-mcp-server@3.2.1`, package `gitHead` remains `74438bc48ea9853e2e3e56f72535edc4f5c34bf6`, and tarball SHA-256 remains `675688dffcd746b8bb6ac7f077b64b7382c4a305f948d44ba526e67be50396df`.
- Hosted `initialize` still returns `serverInfo.version=3.2.1`.
- No skill body/tool-choice change required beyond source SHA refresh.
Rechecked on 2026-07-23:
- Official repo `main` advanced to `0de23f94b7e8539192bdc2008c16592156ada870`.
- npm latest remains `exa-mcp-server@3.2.1`; package `gitHead` and tarball SHA-256 remain unchanged.
- Hosted advanced schema now uses category `publication` instead of `research paper` and exposes deprecated `highlightsNumSentences` / `highlightsPerUrl` compatibility fields.
Rechecked on 2026-08-15:
- Official repo `main` advanced to `e64c11f2d3b4400ffbda8ccdd9658a450cc9d270`.
- npm latest is `exa-mcp-server@3.4.0`; package `gitHead` is `a664592b5dd7c5598b70158c771dcc5c2a4fb2c1`; tarball SHA-256 is `cbc24567086756cde087eee8d8f617b7c423b1761e068e2b52e167b013e63f19`.
- Hosted `initialize` still returns `serverInfo.version=3.2.1`.
- Anonymous hosted `tools/list` still returns `web_search_exa`, `web_search_advanced_exa`, `company_research_exa`, `web_fetch_exa`, `people_search_exa`, and `get_code_context_exa` with the same parameter surface, including category `publication` and deprecated highlight compatibility fields.
- No skill body/tool-choice change required beyond source SHA and npm metadata refresh.
Rechecked on 2026-09-04:
- Official repo `main` is `15ffb50519e719dc791cdc750ce5ed1934c0a1ed`; npm latest is `exa-mcp-server@3.4.1` with package `gitHead` `66bacbe4afd35a7e1671be9ab55c2b6bf60aff34`.
- Hosted `initialize` still returns `serverInfo.version=3.2.1`.
- Anonymous hosted `tools/list` returns the same six requested tools and parameter surface, including category `publication` and deprecated highlight compatibility fields.
- The skill's tool selection and invocation guidance remain unchanged.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |