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
• 🎯 Verification: AI validates that entities meet your criteria
• 🔗 Webhooks: Real-time notifications for collection updates
• 📥 Imports: Bring your own CSV data into Websets for enrichment or scoping

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 title and/or metadata
delete_webset	Delete a webset and all its items
preview_webset	Preview how a search query will be interpreted before creating a webset

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

Webhooks

Tool	Description
create_webhook	Subscribe to real-time HTTP callbacks for webset events
get_webhook	Get details about a specific webhook
update_webhook	Update a webhook's URL, events, or metadata
delete_webhook	Delete a webhook
list_webhooks	List all webhooks in your account

Imports

Tool	Description
create_import	Create an import to upload your own CSV data into Websets
get_import	Get details about a specific import including upload URL
list_imports	List all imports in your account

Events

Tool	Description
list_events	List system events (search, enrichment, webset lifecycle, etc.)

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 Desk

... View full README on GitHub