websets-mcp-server

Cancel a running enrichment operation. Only enrichments with status 'running' can be canceled; enrichments still in 'pending' status are unaffected.

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

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…

Create a new import to upload your own data (CSV) into Websets. Imports can be used for enrichment, scoped searches, or excluding known results. Returns an uploadUrl where you can PUT your CSV file. Example call: { "format": "csv", "size": 1024, "count": 100, "entity": {"type": "company"}, …

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). For "custom" type, include description: {type: "custom", description: "SaaS tool…

Create a webhook to receive real-time HTTP callbacks when events occur in your websets. Example call: { "url": "https://example.com/webhook", "events": ["webset.search.completed", "webset.enrichment.completed"] }

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)…

Delete a webhook. The webhook stops receiving notifications immediately and cannot be recovered.

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

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

Get details about a specific import, including its status, upload URL, and processing progress.

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

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

Get details about a specific webhook. The webhook secret is not returned here for security — it is only shown when the webhook is first created.

Get details about a specific webset by ID or externalId. Returns full webset information including status, searches, enrichments, imports, and metadata. REQUIRED: You must pass the "id" parameter. Use the webset ID returned from create_webset (e.g. "ws_abc123") or an externalId you assigned. TIP: …

List system events with optional filtering. Events track all state changes across websets, searches, enrichments, and webhooks.

List all imports. Returns a paginated list of imports with their status and metadata.

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

List all webhooks in your account. Returns a paginated list of webhooks with their URL, events, status, and metadata.

List all websets in your account. Returns a paginated list of webset collections with their current status, searches, enrichments, imports, and metadata.

Preview how a search query will be interpreted before creating a webset. Returns the detected entity type, generated search criteria, and suggested enrichment columns. Useful for understanding what a query will produce before committing.

Update a webhook's URL, events, or metadata. Changes take effect immediately. The webhook keeps its current status (active/inactive) when updated.

Update a webset's title and/or metadata.