by exa-labs
Exa MCP for web search and web crawling!
# Add to your Claude Code skills
git clone https://github.com/exa-labs/exa-mcp-serverConnect AI assistants to Exa's search capabilities: web search, code search, and company research.
Full Documentation | npm Package | Get Your Exa API Key
Connect to Exa's hosted MCP server:
https://mcp.exa.ai/mcp
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
}
Add to .vscode/mcp.json:
{
"servers": {
"exa": {
"type": "http",
"url": "https://mcp.exa.ai/mcp"
}
}
}
claude mcp add --transport http exa https://mcp.exa.ai/mcp
Exa is available as a native Claude Connector — no config files or terminal commands needed.
No comments yet. Be the first to share your thoughts!
That's it! Claude will now have access to Exa's search tools.
Add to your config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.exa.ai/mcp"]
}
}
}
codex mcp add exa --url https://mcp.exa.ai/mcp
Add to your opencode.json:
{
"mcp": {
"exa": {
"type": "remote",
"url": "https://mcp.exa.ai/mcp",
"enabled": true
}
}
}
Open the MCP Store panel (from the "..." dropdown in the side panel), then add a custom server with:
https://mcp.exa.ai/mcp
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"exa": {
"serverUrl": "https://mcp.exa.ai/mcp"
}
}
}
Add to your Zed settings:
{
"context_servers": {
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
}
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"exa": {
"httpUrl": "https://mcp.exa.ai/mcp"
}
}
}
In v0, select Prompt Tools > Add MCP and enter:
https://mcp.exa.ai/mcp
Go to Settings > MCP Servers > Add MCP Server and add:
{
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
Add to ~/.kiro/settings/mcp.json:
{
"mcpServers": {
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
}
Add to your Roo Code MCP config:
{
"mcpServers": {
"exa": {
"type": "streamable-http",
"url": "https://mcp.exa.ai/mcp"
}
}
}
For clients that support remote MCP:
{
"mcpServers": {
"exa": {
"url": "https://mcp.exa.ai/mcp"
}
}
}
For clients that need mcp-remote:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.exa.ai/mcp"]
}
}
}
Use the npm package with your API key. Get your API key.
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["-y", "exa-mcp-server"],
"env": {
"EXA_API_KEY": "your_api_key"
}
}
}
}
Enabled by Default:
| Tool | Description |
| ---- | ----------- |
| web_search_exa | Search the web for any topic and get clean, ready-to-use content |
| web_fetch_exa | Get the full content of a specific webpage from a known URL |
Off by Default:
| Tool | Description |
| ---- | ----------- |
| web_search_advanced_exa | Advanced web search with full control over filters, domains, dates, and content options |
Deprecated (still available for backwards compatibility):
| Tool | Use instead |
| ---- | ----------- |
| get_code_context_exa | web_search_exa |
| company_research_exa | web_search_advanced_exa |
| crawling_exa | web_fetch_exa |
| people_search_exa | web_search_advanced_exa |
| linkedin_search_exa | web_search_advanced_exa |
| deep_researcher_start | Research API |
| deep_researcher_check | Research API |
| deep_search_exa | web_search_advanced_exa |
Enable additional tools with the tools parameter:
https://mcp.exa.ai/mcp?exaApiKey=YOUR_KEY&tools=web_search_exa,web_search_advanced_exa,web_fetch_exa
Ready-to-use skills for Claude Code. Each skill teaches Claude how to use Exa search for a specific task. Copy the content inside a dropdown and paste it into Claude Code — it handles the rest.
Copy the content below and paste it into Claude Code. It will set up the MCP connection and skill for you.
Step 1: Install or update Exa MCP
If Exa MCP already exists in your MCP configuration, either uninstall it first and install the new one, or update your existing MCP config with this endpoint. Run this command in your terminal:
claude mcp add --transport http exa "https://mcp.exa.ai/mcp?tools=web_search_advanced_exa"
Step 2: Add this Claude skill
---
name: company-research
description: Company research using Exa search. Finds company info, competitors, news, financials, LinkedIn profiles, builds company lists. Use when researching companies, doing competitor analysis, market research, or building company lists.
context: fork
---
# Company Research
## Tool Restriction (Critical)
ONLY use `web_search_advanced_exa`. Do NOT use `web_search_exa` or any other Exa tools.
## Token Isolation (Critical)
Never run Exa searches in main context. Always spawn Task agents:
- Agent runs Exa search internally
- Agent processes results using LLM intelligence
- Agent returns only distilled output (compact JSON or brief markdown)
- Main context stays clean regardless of search volume
## Dynamic Tuning
No hardcoded numResults. Tune to user intent:
- User says "a few" → 10-20
- User says "comprehensive" → 50-100
- User specifies number → match it
- Ambiguous? Ask: "How many companies would you like?"
## Query Variation
Exa returns different results for different phrasings. For coverage:
- Generate 2-3 query variations
- Run in parallel
- Merge and deduplicate
## Categories
Use appropriate Exa `category` depending on what you need:
- `company` → homepages, rich metadata (headcount, location, funding, revenue)
- `news` → press coverage, announcements
- `people` → LinkedIn profiles (public data)
- No category (`type: "auto"`) → general web results, deep dives, broader context
Start with `category: "company"` for discovery, then use other categories or no category for deeper research.
### Category-Specific Filter Restrictions
When using `category: "company"`, these parameters cause 400 errors:
- `includeDomains` / `excludeDomains`
- `startPublishedDate` / `endPublishedDate`
- `startCrawlDate` / `endCrawlDate`
When searching without a category (or with `news`), domain and date filters work fine.
**Universal restriction:** `includeText` and `excludeText` only support **single-item arrays**. Multi-item arrays cause 400 errors across all categories.
## LinkedIn
Public LinkedIn via Exa: `category: "people"`, no other filters.
Auth-required LinkedIn → use Claude in Chrome browser fallback.
## Browser Fallback
Auto-fallback to Claude in Chrome when:
- Exa returns insufficient results
- Content is auth-gated
- Dynamic pages need JavaScript
## Examples
### Discovery: find companies in a space
```
web_search_advanced_exa {
"query": "AI infrastructure startups San Francisco",
"category": "company",
"numResults": 20,
"type": "auto"
}
```
### Deep dive: research a specific company
```
web_search_advanced_exa {
"query": "Anthropic funding rounds valuation 2024",
"type": "deep",
"numResults": 10,
"includeDomains": ["techcrunch.com", "crunchbase.com", "bloomberg.com"]
}
```
### News coverage
```
web_search_advanced_exa {
"query": "Anthropic AI safety",
"category": "news",
"numResults": 15,
"startPublishedDate": "2024-01-01"
}
```
### LinkedIn profiles
```
web_search_advanced_exa {
"query": "VP Engineering AI infrastructure",
"category": "people",
"numResults": 20
}
```
## Output Format
Return:
1) Results (stru