Exa MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Exa MCP Server search for the latest AI breakthroughs in healthcare"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Exa MCP Server 🔍
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Demo video https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60
What is MCP? 🤔
The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.
Related MCP server: Perplexity MCP Server
What does this server do? 🚀
The Exa MCP server:
Enables AI assistants to perform web searches using Exa's powerful search API
Provides structured search results including titles, URLs, and content snippets
Caches recent searches as resources for reference
Handles rate limiting and error cases gracefully
Supports real-time web crawling for fresh content
Prerequisites 📋
Before you begin, ensure you have:
Node.js (v18 or higher)
Claude Desktop installed
An Exa API key
Git installed
You can verify your Node.js installation by running:
node --version # Should show v18.0.0 or higherInstallation 🛠️
NPM Installation
npm install -g exa-mcp-serverUsing Smithery
To install the Exa MCP server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install exa --client claudeManual Installation
Clone the repository:
git clone https://github.com/exa-labs/exa-mcp-server.git
cd exa-mcp-serverInstall dependencies:
npm installBuild the project:
npm run buildCreate a global link (this makes the server executable from anywhere):
npm linkConfiguration ⚙️
1. Configure Claude Desktop to recognize the Exa MCP server
You can find claude_desktop_config.json inside the settings of Claude Desktop app:
Open the Claude Desktop app and enable Developer Mode from the top-left menu bar.
Once enabled, open Settings (also from the top-left menu bar) and navigate to the Developer Option, where you'll find the Edit Config button. Clicking it will open the claude_desktop_config.json file, allowing you to make the necessary edits.
OR (if you want to open claude_desktop_config.json from terminal)
For macOS:
Open your Claude Desktop configuration:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonFor Windows:
Open your Claude Desktop configuration:
code %APPDATA%\Claude\claude_desktop_config.json2. Add the Exa server configuration:
{
"mcpServers": {
"exa": {
"command": "npx",
"args": ["/path/to/exa-mcp-server/build/index.js"],
"env": {
"EXA_API_KEY": "your-api-key-here"
}
}
}
}Replace your-api-key-here with your actual Exa API key from dashboard.exa.ai/api-keys.
3. Restart Claude Desktop
For the changes to take effect:
Completely quit Claude Desktop (not just close the window)
Start Claude Desktop again
Look for the 🔌 icon to verify the Exa server is connected
Usage 🎯
Once configured, you can ask Claude to perform web searches. Here are some example prompts:
Can you search for recent developments in quantum computing?Search for and summarize the latest news about artificial intelligence startups in new york.Find and analyze recent research papers about climate change solutions.Search for today's breaking news about tech.Search for the top 10 AI research papers from 2023, and only use live crawling as a fallback.Search for electric vehicles and return 3 results, always using live crawling.The server will:
Process the search request
Query the Exa API with optimal settings (including live crawling)
Return formatted results to Claude
Cache the search for future reference
Features ✨
Simplified Web Search Tool: Enables Claude to search the web with just a query parameter
Customizable Search Parameters: Control the number of results and live crawling strategy
Automatic Live Crawling: Uses real-time crawling based on specified strategy
Preset Optimal Parameters: Uses best defaults for result count and character limits
Search Caching: Saves recent searches as resources for reference
Error Handling: Gracefully handles API errors and rate limits
Type Safety: Full TypeScript implementation with Zod validation
MCP Compliance: Fully implements the latest MCP protocol specification
Testing with MCP Inspector 🔍
You can test the server directly using the MCP Inspector:
npx @modelcontextprotocol/inspector node ./build/index.jsThis opens an interactive interface where you can explore the server's capabilities, execute search queries, and view cached search results.
Troubleshooting 🔧
Common Issues
Server Not Found
Verify the npm link is correctly set up
Check Claude Desktop configuration syntax
Ensure Node.js is properly installed
API Key Issues
Confirm your EXA_API_KEY is valid
Check the EXA_API_KEY is correctly set in the Claude Desktop config
Verify no spaces or quotes around the API key
Connection Issues
Restart Claude Desktop completely
Check Claude Desktop logs:
# macOS tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type "%APPDATA%\Claude\logs\mcp*.log"
Getting Help
If you encounter issues, review the MCP Documentation or visit the GitHub discussions for community support.
Acknowledgments 🙏
Exa AI for their powerful search API
Model Context Protocol for the MCP specification
Anthropic for Claude Desktop
Available Tools
2 toolsget_code_context_exaARead-onlyIdempotent
Search and get relevant context for any programming task. Exa-code has the highest quality and freshest context for libraries, SDKs, and APIs. Use this tool for ANY question or task for related to programming. RULE: when the user's query contains exa-code or anything related to code, you MUST use this tool.
Inputs: query (required), tokensNum.
web_search_exaARead-onlyIdempotent
Search the web using Exa AI - performs real-time web searches and can scrape content from specific URLs. Supports configurable result counts and returns the content from the most relevant websites.
Inputs: query (required), numResults, livecrawl, type, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: get_code_context_exa is specialized for programming-related searches with high-quality code context, while web_search_exa is a general web search tool for broader queries. There is no overlap in functionality, making it easy for an agent to choose the correct tool based on the query content.
Both tools follow a consistent naming pattern: they use snake_case and start with a verb (get, search) followed by a noun (code_context, web). The pattern is uniform across the set, with no deviations in style or structure.
With only 2 tools, the server feels thin for a general-purpose search domain, as it might lack coverage for intermediate or specialized tasks beyond code and web searches. However, the tools are well-defined, so it's borderline but not severely mismatched.
The server covers two key search domains (code and web), but there are notable gaps: it lacks tools for other common search types (e.g., image, news, academic) or advanced operations like filtering or saving results. This could limit agent effectiveness in broader search scenarios.
Maintenance
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Official Exa MCP for web search, content fetching, and multi-step research.
Give AI assistants access to real-time data. Search the web, compare flights, find hotels, and more.
Related MCP Servers
- AlicenseAqualityBmaintenanceA Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.846,492 npm5,232MIT
- AlicenseBqualityDmaintenanceA server facilitating web search functionality by utilizing Perplexity AI's API, designed to integrate with the Claude desktop client for enhanced search queries.1311MIT
- FlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to perform real-time web searches using the Exa AI Search API in a safe and controlled manner.2-
- AlicenseBqualityDmaintenanceA server that integrates with Claude Desktop to enable real-time web research capabilities, allowing users to search Google, extract webpage content, and capture screenshots directly from conversations.3MIT