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.
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-25662379fab5750cbc8334f096ff986ab1b7152488afffab5b0e275995310b6e978 - Tool schemas can change. Before adding new parameters, verify with
tools/listthrough 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
queryrequired: semantically rich natural-language query. Can includecategory:companyorcategory:people.numResultsoptional: default10.- No
type,livecrawl,contextMaxCharacters, ortokensNumon current hosted schema.
{"query":"latest AI safety research June 2026","numResults":10}
web_search_advanced_exa
queryrequired.- 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; preferhighlightsMaxCharacters. - 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
urlsrequired: array of URLs. Batch multiple URLs in one call.maxCharactersoptional: default3000.
{"urls":["https://docs.exa.ai/reference"],"maxCharacters":5000}
Deprecated But Still Available
get_code_context_exa: useweb_search_exainstead. Current schema isquery,numResults; oldtokensNumis obsolete.company_research_exa: useweb_search_advanced_exawithcategory:"company"instead. Schema iscompanyName,numResults; default3.people_search_exa: useweb_search_advanced_exawithcategory:"people"instead.crawling_exa: useweb_fetch_exainstead.deep_search_exa: useweb_search_advanced_exainstead; 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 returnedMcp-Session-Idresponse header. - POST
notifications/initializedwith that header. - POST
tools/listortools/callwith that header. - If response is
text/event-stream, parse JSON fromdata: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_exacall. - For dated/current questions, calculate exact date ranges first and pass
startPublishedDate/endPublishedDatethroughweb_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_exacategories rather than deprecated specialized tools. - Mention source uncertainty when Exa returns sparse, conflicting, or old results.
References
- Tool fields:
references/exa-tools.md
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 |