Price Per TokenPrice Per Token
Exa Websets

Exa Websets

by exa-labs

GitHub 4 2,940 uses Remote
0

About

IBM

Tools 16

create_webset

Create a new Webset collection. Websets are collections of web entities (companies, people, papers) that can be automatically searched, verified, and enriched with custom data. IMPORTANT PARAMETER FORMATS: - searchCriteria: MUST be array of objects like [{description: "..."}] (NOT array of strings) - enrichments: Each must have description field, optional format and options - enrichment options: MUST be array of objects like [{label: "..."}] (NOT array of strings) Example call: { "name": "AI Startups", "searchQuery": "AI startups in San Francisco", "searchCriteria": [{"description": "Founded after 2020"}], "enrichments": [ {"description": "CEO name", "format": "text"}, {"description": "Company stage", "format": "options", "options": [{"label": "Seed"}, {"label": "Series A"}]} ] }

list_websets

List all websets in your account. Returns a paginated list of webset collections with their current status and item counts.

get_webset

Get details about a specific webset by ID or externalId. Returns full webset information including status, item count, and metadata.

update_webset

Update a webset's metadata. Use this to add or update custom key-value pairs associated with the webset.

delete_webset

Delete a webset and all its items. This action is permanent and cannot be undone.

list_webset_items

List all items in a webset. Returns entities (companies, people, papers) that have been discovered and verified in the collection.

get_item

Get a specific item from a webset by its ID. Returns detailed information about the item including all enrichment data.

create_search

Create a new search to find and add items to a webset. The search will discover entities matching your query and criteria. IMPORTANT PARAMETER FORMATS: - entity: MUST be an object like {type: "company"} (NOT a string) - criteria: MUST be array of objects like [{description: "..."}] (NOT array of strings) Example call: { "websetId": "webset_123", "query": "AI startups in San Francisco", "entity": {"type": "company"}, "criteria": [{"description": "Founded after 2020"}], "count": 10 }

get_search

Get details about a specific search, including its status, progress, and results found.

cancel_search

Cancel a running search operation. This will stop the search from finding more items.

create_enrichment

Create a new enrichment for a webset. Enrichments automatically extract custom data from each item using AI agents (e.g., 'company revenue', 'CEO name', 'funding amount'). IMPORTANT PARAMETER FORMATS: - options (when format is "options"): MUST be array of objects like [{label: "..."}] (NOT array of strings) Example call (text format): {"websetId": "webset_123", "description": "CEO name", "format": "text"} Example call (options format): {"websetId": "webset_123", "description": "Company stage", "format": "options", "options": [{"label": "Seed"}, {"label": "Series A"}]}

get_enrichment

Get details about a specific enrichment, including its status and progress.

update_enrichment

Update an enrichment's metadata. You can associate custom key-value pairs with the enrichment.

delete_enrichment

Delete an enrichment from a webset. This will remove all enriched data for this enrichment from all items.

cancel_enrichment

Cancel a running enrichment operation. This will stop the enrichment from processing more items.

create_monitor

Create a monitor to automatically update a webset on a schedule. Monitors run search operations to find new items. IMPORTANT PARAMETER FORMATS: - cron: MUST be 5-field format "minute hour day month weekday" (e.g., "0 9 * * 1") - entity: MUST be an object like {type: "company"} (NOT a string) - criteria: MUST be array of objects like [{description: "..."}] (NOT array of strings) Example call: { "websetId": "webset_123", "cron": "0 9 * * 1", "query": "New AI startups", "entity": {"type": "company"}, "criteria": [{"description": "Founded in last 30 days"}], "count": 10 }

README

Exa Websets MCP Server

[](https://smithery.ai/server/@exa-labs/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 configuration:

    {
      "mcpServers": {
        "websets": {
          "type": "http",
          "url": "https://mcp.exa.ai/websets",
          "headers": {}
        }
      }
    }
    

    Tool Schema Reference

    ⚠️ Important for AI Callers: See TOOL_SCHEMAS.md for exact parameter formats and examples.

    Key Schema Rules:

  • criteria must be an array of objects: [{description: "..."}] (NOT an array of strings)
  • entity must be an object: {type: "company"} (NOT a string)
  • options must be an array of objects: [{label: "..."}] (NOT an array of strings)
  • These formats ensure consistency across all tools and match the Websets API specification.

    Usage Examples

    Once configured, you can ask Claude to interact with Websets:

    Creating a Webset

    Create a webset of AI startups in San Francisco with 20 companies. 
    Add enrichments for revenue, employee count, and funding stage.
    

    Listing and Viewing Websets

    ``` List all my websets and show me the details of the one called "

    Related MCP Servers

    AI Research Assistant

    AI Research Assistant

    hamid-vakilzadeh

    AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar

    Web & Search
    12 8
    Linkup

    Linkup

    LinkupPlatform

    Linkup is a real-time web search and content extraction service that enables AI assistants to search the web and retrieve information from trusted sources. It provides source-backed answers with citations, making it ideal for fact-checking, news gathering, and research tasks. Key features of Linkup: - Real-time web search using natural language queries to find current information, news, and data - Page fetching to extract and read content from any webpage URL - Search depth modes: Standard for direct-answer queries and Deep for complex research across multiple sources - Source-backed results with citations and context from relevant, trustworthy websites - JavaScript rendering support for accessing dynamic content on JavaScript-heavy pages

    Web & Search
    2 24
    Math-MCP

    Math-MCP

    EthanHenrickson

    Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support

    Developer Tools
    22 81