Skip to main content

Documentation Index

Fetch the complete documentation index at: https://exa.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Websets MCP connects AI assistants to Exa’s Websets API for building and enriching collections of web entities like companies, people, and research papers. What you can do:
  • Find AI startups in San Francisco with funding over $10M
  • Build a database of companies and enrich with CEO names, revenue, employee counts
  • Create a list of research papers and extract key findings
  • Subscribe to webhooks to be notified when searches and enrichments complete
  • Bring your own CSV data into Websets via imports for scoping or exclusion

Installation

Get your Exa API key

Connect to Websets MCP:
https://websetsmcp.exa.ai/mcp?exaApiKey=YOUR_EXA_API_KEY
Install with one clickOr add to ~/.cursor/mcp.json:
{
  "mcpServers": {
    "websets": {
      "url": "https://websetsmcp.exa.ai/mcp?exaApiKey=YOUR_EXA_API_KEY"
    }
  }
}


Available Tools

Webset management
ToolDescription
create_websetCreate a collection with search query, criteria, and enrichments
list_websetsList all websets in your account
get_websetGet details about a webset
update_websetUpdate a webset’s title and/or metadata
delete_websetDelete a webset and all its items
preview_websetPreview how a query will be interpreted before creating a webset
Items
ToolDescription
list_webset_itemsList items in a webset with their data
get_itemGet details about a specific item
Searches
ToolDescription
create_searchAdd more entities to a webset
get_searchCheck search status
cancel_searchCancel a running search
Enrichments
ToolDescription
create_enrichmentExtract data from items (text, number, date, email, phone, url, options)
get_enrichmentCheck enrichment status
cancel_enrichmentCancel a running enrichment
Webhooks
ToolDescription
create_webhookSubscribe to real-time HTTP callbacks for webset events
get_webhookGet details about a webhook
update_webhookUpdate a webhook’s URL, events, or metadata
delete_webhookDelete a webhook
list_webhooksList all webhooks in your account
Imports
ToolDescription
create_importUpload your own CSV data into Websets
get_importGet details about an import including its upload URL
list_importsList all imports in your account
Events
ToolDescription
list_eventsList system events (search, enrichment, webset lifecycle, etc.)
Scheduled monitors are part of the underlying Websets API and the websets.exa.ai dashboard, but are not currently exposed as MCP tools.

Free searches are included. A Websets plan is required for continued use.

Key Concepts

Entity Types: Search for different kinds of entities:
  • company - companies and startups
  • person - individuals (e.g., for recruiting)
  • research_paper - academic papers
  • article - blog posts and news articles
  • custom - define your own entity type
Criteria: Natural language filters that determine which results are included. Every result must satisfy all criteria to appear in your webset. Use criteria for hard requirements like “Founded after 2020” or “Located in San Francisco”. Enrichments: Data extractors that pull additional information from results that have already passed your criteria. Enrichments don’t affect filtering-they add columns of data to your results. Use enrichments to extract things like CEO name, employee count, or contact info. Enrichment Formats: The data type for an enrichment:
  • text - free-form text (CEO name, description)
  • number - numeric values (employee count, revenue)
  • date - dates (founding date, funding date)
  • email, phone, url - contact info
  • options - multiple choice (e.g., funding stage: Seed, Series A, Series B)
Example: To find AI startups and get their CEO names:
  • Criteria (filters): “AI company”, “Founded after 2020”, “Has raised funding”
  • Enrichments (data to extract): CEO name (text), funding amount (number), founding date (date)


Resources

Create a Webset
Create a webset of AI startups in San Francisco founded after 2020. Find 10 companies and enrich with CEO name and funding amount.
Add More Entities
Search for 5 more AI companies that have raised Series A funding.
Extract Data
Add an enrichment to extract employee count for each company.
Subscribe to Events
Create a webhook to https://example.com/hook subscribed to webset.search.completed and webset.enrichment.completed events.