---

name: web-search-exa description: "Neural web search, content extraction, company and people research, code search, and deep research via the Exa MCP server. Use when you need to: (1) search the web with semantic understanding — not just keywords, (2) find research papers, news, tweets, companies, or people, (3) extract clean content from URLs, (4) find semantically similar pages to a known URL, (5) get code examples and documentation, (6) run deep multi-step research with a report, (7) get a quick synthesized answer with citations. NOT for: local file operations, non-web tasks, or anything that doesn't involve web search or content retrieval."

Exa — Neural Web Search & Research

Exa is a neural search engine. Unlike keyword-based search, it understands meaning — you describe the page you're looking for and it finds it. Returns clean, LLM-ready content with no scraping needed.

MCP server: https://mcp.exa.ai/mcp Free tier: generous rate limits, no key needed for basic tools API key: dashboard.exa.ai/api-keys — unlocks higher limits + all tools Docs: exa.ai/docs GitHub: github.com/exa-labs/exa-mcp-server

Setup

Add the MCP server to your agent config:

# OpenClaw
openclaw mcp add exa --url "https://mcp.exa.ai/mcp"

Or in any MCP config JSON:

{
  "mcpServers": {
    "exa": {
      "url": "https://mcp.exa.ai/mcp"
    }
  }
}

To unlock all tools and remove rate limits, append your API key:

https://mcp.exa.ai/mcp?exaApiKey=YOUR_EXA_KEY

To enable specific optional tools:

https://mcp.exa.ai/mcp?exaApiKey=YOUR_KEY&tools=web_search_exa,web_search_advanced_exa,people_search_exa,crawling_exa,company_research_exa,get_code_context_exa,deep_researcher_start,deep_researcher_check,deep_search_exa

---

Tool Reference

Default tools (available without API key)

Tool	What it does
web_search_exa	General-purpose web search — clean content, fast
get_code_context_exa	Code examples + docs from GitHub, Stack Overflow, official docs
company_research_exa	Company overview, news, funding, competitors

Optional tools (enable via tools param, need API key for some)

Tool	What it does
web_search_advanced_exa	Full-control search: domain filters, date ranges, categories, content modes
crawling_exa	Extract full page content from a known URL — handles JS, PDFs, complex layouts
people_search_exa	Find LinkedIn profiles, professional backgrounds, experts
deep_researcher_start	Kick off an async multi-step research agent → detailed report
deep_researcher_check	Poll status / retrieve results from deep research
deep_search_exa	Single-call deep search with synthesized answer + citations (needs API key)

---

web_search_exa

Fast general search. Describe what you're looking for in natural language.

Parameters:

• query (string, required) — describe the page you want to find
• numResults (int) — number of results, default 10
• type — auto (best quality), fast (lower latency), deep (multi-step reasoning)
• livecrawl — fallback (default) or preferred (always fetch fresh)
• contextMaxCharacters (int) — cap the returned content size

web_search_exa {
  "query": "blog posts about using vector databases for recommendation systems",
  "numResults": 8
}

web_search_exa {
  "query": "latest OpenAI announcements March 2026",
  "numResults": 5,
  "type": "fast"
}

---

web_search_advanced_exa

The power-user tool. Everything web_search_exa does, plus domain filters, date filters, category targeting, and content extraction modes.

Extra parameters beyond basic search:

Parameter	Type	What it does
includeDomains	string[]	Only return results from these domains (max 1200)
excludeDomains	string[]	Block results from these domains
category	string	Target content type — see table below
startPublishedDate	string	ISO date, results published after this
endPublishedDate	string	ISO date, results published before this
maxAgeHours	int	Content freshness — 0 = always livecrawl, -1 = cache only, 24 = cache if <24h
contents.highlights	object	Extractive snippets relevant to query. Set maxCharacters to control size
contents.text	object	Full page as clean markdown. Set maxCharacters to cap
contents.summary	object	LLM-generated summary. Supports query and JSON schema for structured extraction

Categories:

Category	Best for
company	Company pages, LinkedIn company profiles
people	LinkedIn profiles, professional bios, personal sites
research paper	arXiv, academic papers, peer-reviewed research
news	Current events, journalism
tweet	Posts from X/Twitter
personal site	Blogs, personal pages
financial report	SEC filings, earnings reports

Examples

Research papers:

web_search_advanced_exa {
  "query": "transformer architecture improvements for long-context windows",
  "category": "research paper",
  "numResults": 15,
  "contents": { "highlights": { "maxCharacters": 3000 } }
}

Company list building with structured extraction:

web_search_advanced_exa {
  "query": "Series A B2B SaaS companies in climate tech founded after 2022",
  "category": "company",
  "numResults": 25,
  "contents": {
    "summary": {
      "query": "company name, what they do, funding stage, location",
      "schema": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "description": { "type": "string" },
          "funding": { "type": "string" },
          "location": { "type": "string" }
        }
      }
    }
  }
}

People search — find candidates with specific profiles:

web_search_advanced_exa {
  "query": "machine learning engineers at fintech startups in NYC with experience in fraud detection",
  "category": "people",
  "numResults": 20,
  "contents": { "highlights": { "maxCharacters": 2000 } }
}

Finding pages similar to a known URL: Use the URL itself as the query — Exa will find semantically similar pages:

web_search_advanced_exa {
  "query": "https://linkedin.com/in/some-candidate-profile",
  "numResults": 15,
  "contents": { "highlights": { "maxCharacters": 2000 } }
}

Recent news with freshness control:

web_search_advanced_exa {
  "query": "AI regulation policy updates",
  "category": "news",
  "maxAgeHours": 72,
  "numResults": 10,
  "contents": { "highlights": { "maxCharacters": 4000 } }
}

Scoped domain search:

web_search_advanced_exa {
  "query": "authentication best practices",
  "includeDomains": ["owasp.org", "auth0.com", "docs.github.com"],
  "numResults": 10,
  "contents": { "text": { "maxCharacters": 5000 } }
}

---

company_research_exa

One-call company research. Returns business overview, recent news, funding, and competitive landscape.

company_research_exa { "query": "Stripe payments company overview and recent news" }

company_research_exa { "query": "what does Anduril Industries do and who are their competitors" }

---

people_search_exa

Find professionals by role, company, location, expertise. Returns LinkedIn profiles and bios.

people_search_exa { "query": "VP of Engineering at healthcare startups in San Francisco" }

people_search_exa { "query": "AI researchers specializing in multimodal models" }

---

get_code_context_exa

Search GitHub repos, Stack Overflow, and documentation for code examples and API usage patterns.

get_code_context_exa { "query": "how to implement rate limiting in Express.js with Redis" }

get_code_context_exa { "query": "Python asyncio connection pooling example with aiohttp" }

---

crawling_exa

Extract clean content from a specific URL. Handles JavaScript-rendered pages, PDFs, and complex layouts. Returns markdown.

crawling_exa { "url": "https://arxiv.org/abs/2301.07041" }

Good for when you already have the URL and want to read the page.

---

deep_researcher_start + deep_researcher_check

Long-running async research. Exa's research agent searches, reads, and compiles a detailed report.

Start a research task:

deep_researcher_start {
  "query": "competitive landscape of AI code generation tools in 2026 — key players, pricing, technical approaches, market share"
}

Check status (use the researchId from the start response):

deep_researcher_check { "researchId": "abc123..." }

Poll deep_researcher_check until status is completed. The final response includes the full report.

---

deep_search_exa

Single-call deep search: expands your query across multiple angles, searches, reads results, and returns a synthesized answer with grounded citations. Requires API key.

deep_search_exa { "query": "what are the leading approaches to multimodal RAG in production systems" }

Supports structured output via outputSchema:

deep_search_exa {
  "query": "top 10 aerospace companies by revenue",
  "type": "deep",
  "outputSchema": {
    "type": "object",
    "required": ["companies"],
    "properties": {
      "companies": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": { "type": "string" },
            "revenue": { "type": "string" },
            "hq": { "type": "string" }
          }
        }
      }
    }
  }
}

---

Query Craft

Exa is neural — it matches on meaning, not keywords. Write queries like you'd describe the ideal page to a colleague.

Do: "blog post about using embeddings for product recommendations at scale" Don't: "embeddings product recommendations"

Do: "Stripe payments company San Francisco fintech" Don't: "Stripe" (too ambiguous)

• Use category when you know the content type — it makes a big difference.
• For broader coverage, run 2-3 query variations in parallel and deduplicate results.
• For agentic workflows, use highlights instead of full text — it's 10x more token-efficient while keeping the relevant parts.

Token Efficiency

Content mode	When to use
highlights	Agent workflows, factual lookups, multi-step pipelines — most token-efficient
text	Deep analysis, when you need full page context
summary	Quick overviews, structured extraction with JSON schema

Set maxCharacters on any content mode to control output size.

When to Reach for Which Tool

I need to...	Use
Quick web lookup	web_search_exa
Research papers, academic search	web_search_advanced_exa + category: "research paper"
Company intel, competitive analysis	company_research_exa or advanced + category: "company"
Find people, candidates, experts	people_search_exa or advanced + category: "people"
Code examples, API docs	get_code_context_exa
Read a specific URL	crawling_exa
Find pages similar to a URL	web_search_advanced_exa with URL as query
Recent news / tweets	Advanced + category: "news" or "tweet" + maxAgeHours
Detailed research report	deep_researcher_start → deep_researcher_check
Quick answer with citations	deep_search_exa

---

Docs: exa.ai/docs — Dashboard: dashboard.exa.ai — Support: support@exa.ai