Exa Websets MCP Server

A Model Context Protocol (MCP) server for interacting with Exa's Websets API. This server allows you to create and manage websets for AI-powered web search and data collection.

Features

Create Websets: Create new websets with customizable search queries
Manage Websets: Get information about existing websets and list all websets
Predefined Templates: Quick creation of common webset types (marketing agencies, tech companies)
Full API Support: Complete integration with Exa's webset creation parameters

Installation

Clone or download this repository
Install dependencies:
```
pip install -r requirements.txt
```
Set your Exa API key as an environment variable:
```
export EXA_API_KEY="your-exa-api-key-here"
```

Usage

Running the Server

python server.py

By default, the server runs using STDIO transport for local tools. For web deployments, you can specify HTTP transport:

python server.py --transport http --port 8000

Available Tools

`create_webset`

Create a new webset with custom search parameters.

Parameters:

query (required): Natural language search query
count: Number of items to find (default: 10)
entity: Entity type (company, person, article, research_paper)
external_id: External identifier for easier reference
criteria: List of criteria descriptions for evaluation
recall: Whether to provide recall estimates
metadata: Key-value metadata pairs

Example:

create_webset(
    query="AI startups in Europe that raised Series A funding in 2024",
    count=15,
    entity="company",
    external_id="ai-startups-europe-series-a"
)

`get_webset`

Get information about a specific webset.

Parameters:

webset_id (required): The unique identifier for the webset

`list_websets`

List all websets in your account.

`create_marketing_agencies_webset`

Quick template for creating marketing agency websets.

Parameters:

location: Geographic location (default: "US")
focus: Focus area or specialization (default: "consumer products")
count: Number of agencies to find (default: 10)

`create_tech_companies_webset`

Quick template for creating tech company websets.

Parameters:

location: Geographic location (default: "San Francisco")
stage: Company stage (e.g., "startup", "Series A", "public")
count: Number of companies to find (default: 10)

Adding to Claude Desktop

To use this server with Claude Desktop, add it to your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "exa-websets": {
      "command": "/path/to/your/venv/bin/python",
      "args": ["/path/to/exa-websets-mcp/server.py"],
      "env": {
        "EXA_API_KEY": "your-exa-api-key-here"
      }
    }
  }
}

Testing with MCP Inspector

You can test this server using the MCP Inspector:

Start the inspector:
```
npx @modelcontextprotocol/inspector
```
Connect to your server using the STDIO transport with the path to your server.py file.

Configuration

The server uses the following environment variables:

EXA_API_KEY: Your Exa API key (required)

API Reference

This server implements the Exa Websets API endpoints:

POST /v0/websets - Create a webset
GET /v0/websets/{id} - Get a webset
GET /v0/websets - List websets

For full API documentation, see Exa's API Reference.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

Acknowledgments

Built with FastMCP framework
Uses Exa's Websets API for AI-powered web search

Exa Websets MCP Server

A Model Context Protocol (MCP) server for interacting with Exa's Websets API. This server allows you to create and manage websets for AI-powered web search and data collection.

Features

Create Websets: Create new websets with customizable search queries
Manage Websets: Get information about existing websets and list all websets
Predefined Templates: Quick creation of common webset types (marketing agencies, tech companies)
Full API Support: Complete integration with Exa's webset creation parameters

Installation

Clone or download this repository
Install dependencies:
```
pip install -r requirements.txt
```
Set your Exa API key as an environment variable:
```
export EXA_API_KEY="your-exa-api-key-here"
```

Usage

Running the Server

python server.py

By default, the server runs using STDIO transport for local tools. For web deployments, you can specify HTTP transport:

python server.py --transport http --port 8000

Available Tools

`create_webset`

Create a new webset with custom search parameters.

Parameters:

query (required): Natural language search query
count: Number of items to find (default: 10)
entity: Entity type (company, person, article, research_paper)
external_id: External identifier for easier reference
criteria: List of criteria descriptions for evaluation
recall: Whether to provide recall estimates
metadata: Key-value metadata pairs

Example:

create_webset(
    query="AI startups in Europe that raised Series A funding in 2024",
    count=15,
    entity="company",
    external_id="ai-startups-europe-series-a"
)

`get_webset`

Get information about a specific webset.

Parameters:

webset_id (required): The unique identifier for the webset

`list_websets`

List all websets in your account.

`create_marketing_agencies_webset`

Quick template for creating marketing agency websets.

Parameters:

location: Geographic location (default: "US")
focus: Focus area or specialization (default: "consumer products")
count: Number of agencies to find (default: 10)

`create_tech_companies_webset`

Quick template for creating tech company websets.

Parameters:

location: Geographic location (default: "San Francisco")
stage: Company stage (e.g., "startup", "Series A", "public")
count: Number of companies to find (default: 10)

Adding to Claude Desktop

To use this server with Claude Desktop, add it to your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "exa-websets": {
      "command": "/path/to/your/venv/bin/python",
      "args": ["/path/to/exa-websets-mcp/server.py"],
      "env": {
        "EXA_API_KEY": "your-exa-api-key-here"
      }
    }
  }
}

Testing with MCP Inspector

You can test this server using the MCP Inspector:

Start the inspector:
```
npx @modelcontextprotocol/inspector
```
Connect to your server using the STDIO transport with the path to your server.py file.

Configuration

The server uses the following environment variables:

EXA_API_KEY: Your Exa API key (required)

API Reference

This server implements the Exa Websets API endpoints:

POST /v0/websets - Create a webset
GET /v0/websets/{id} - Get a webset
GET /v0/websets - List websets

For full API documentation, see Exa's API Reference.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

Acknowledgments

Built with FastMCP framework
Uses Exa's Websets API for AI-powered web search