Exa Websets MCP Server

A Model Context Protocol (MCP) server that integrates Exa's Websets API with Claude Desktop, Cursor, Windsurf, and other MCP-compatible clients.

What are Websets?

Websets are collections of web entities (companies, people, research papers) that can be automatically discovered, verified, and enriched with custom data. Think of them as smart, self-updating spreadsheets powered by AI web research.

Key capabilities:

• 🔍 Automated Search: Find entities matching natural language criteria
• 📊 Data Enrichment: Extract custom information using AI agents
• 🔄 Monitoring: Schedule automatic updates to keep collections fresh
• 🎯 Verification: AI validates that entities meet your criteria
• 🔗 Webhooks: Real-time notifications for collection updates

Available Tools

This MCP server provides the following tools:

Webset Management

| Tool | Description | | ---- | ----------- | | create_webset | Create a new webset collection with optional search and enrichments | | list_websets | List all your websets with pagination support | | get_webset | Get details about a specific webset | | update_webset | Update a webset's metadata | | delete_webset | Delete a webset and all its items |

Item Management

| Tool | Description | | ---- | ----------- | | list_webset_items | List all items (entities) in a webset | | get_item | Get a specific item from a webset with all enrichment data |

Search Operations

| Tool | Description | | ---- | ----------- | | create_search | Create a new search to find and add items to a webset | | get_search | Get details about a specific search including status and progress | | cancel_search | Cancel a running search operation |

Enrichment Operations

| Tool | Description | | ---- | ----------- | | create_enrichment | Add a new data enrichment to extract custom information | | get_enrichment | Get details about a specific enrichment | | cancel_enrichment | Cancel a running enrichment operation |

Monitoring

| Tool | Description | | ---- | ----------- | | create_monitor | Set up automated monitoring to keep the webset updated |

Installation

Installing via Smithery

To install Exa Websets automatically via Smithery:

npx -y @smithery/cli install @exa-labs/websets-mcp-server

Prerequisites

• Node.js v18 or higher
• Claude Desktop, Cursor, or another MCP-compatible client
• An Exa API key from exa.ai

Using Claude Code (Recommended)

The quickest way to set up Websets MCP:

claude mcp add websets -e EXA_API_KEY=YOUR_API_KEY -- npx -y websets-mcp-server

Replace YOUR_API_KEY with your Exa API key.

Using NPX

# Install globally
npm install -g websets-mcp-server

# Or run directly with npx
npx websets-mcp-server

Configuration

Claude Desktop Configuration

1. Enable Developer Mode

   • Open Claude Desktop
   • Click the menu → Enable Developer Mode
   • Go to Settings → Developer → Edit Config

2. Add to configuration file:

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   Windows: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "websets": {
         "command": "npx",
         "args": [
           "-y",
           "websets-mcp-server"
         ],
         "env": {
           "EXA_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

3. Restart Claude Desktop

   • Completely quit Claude Desktop
   • Start it again
   • Look for the 🔌 icon to verify connection

Cursor and Claude Code Configuration

Use the HTTP-based confi

... View full README on GitHub