Exa integration
Exa integration for AI agents.
Exa integration for AI agents with secure authentication and server-side credential injection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves Exa tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.
What your agents can do
Real Exa actions, managed and audited.
Your user connects Exa once; your agent can then use Exa for web search, content retrieval, similarity search, monitoring, Agent runs, and Websets — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.
- 1
Your user grants Exa access once (OAuth) — the token lands in the vault.
- 2
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
- 3
Every routed call appends a hash-chained audit record — nothing leaves your infra.
Tools & triggers
Supported Exa tools.
58 tools are generated from the published Exa catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.
Showing 58 tools. All published catalog entries are included in this page's server-rendered HTML.
- Answer
- Performs a search based on the query and generates either a direct answer or a detailed summary with citations, depending on the query type.
- answer
- Batch Action on Monitors
- Perform a batch action on monitors matching the provided filters. Supported actions: - **delete**: Permanently remove matching monitors - **pause**: Pause matching monitors - **unpause**: Unpause matching monitors Use `dry_run: true` (the default) to preview which monitors would be affected before performing the action. Results are paginated via the `limit` parameter; loop until `has_more` is `false` to process all matching monitors.
- Monitors
- Cancel a run
- Cancel a queued or running Agent run. If the run has already reached a terminal status, the API returns the existing run.
- Agent
- Create a run
- Create an asynchronous Agent run. By default, the API returns the run object immediately. Set `Accept: text/event-stream` to stream run lifecycle events until the run reaches a terminal status.
- Agent
- Create a Monitor
- Creates a new Monitor to run recurring Exa searches on a schedule. Monitors automatically execute your search query on a recurring schedule and deliver results to your webhook endpoint with automatic deduplication: - **Date-based filtering** only fetches content since the last run - **Semantic deduplication** tracks previous outputs to surface only new developments The response includes a `webhookSecret` that is only returned once at creation time. Store it securely for webhook signature verification.
- Monitors
- Delete a run
- Delete a stored Agent run.
- Agent
- Delete a Monitor
- Deletes a monitor. This cannot be undone.
- Monitors
- Get an Event
- Get a single Event by id. You can subscribe to Events by creating a Webhook.
- Events
- List all Events
- List all events that have occurred in the system. You can paginate through the results using the `cursor` parameter.
- Events
- Find similar links
- Find links similar to the provided URL and optionally retrieve their contents. Deprecated: prefer `/search` with a query describing the source.
- findsimilar
- Get a run
- Retrieve a single Agent run by ID.
- Agent
- Contents
- Contents
- getcontents
- Get a Monitor
- Retrieves a single monitor by its ID.
- Monitors
- Get a Run
- Retrieves a single run by its ID, including the full output if the run is completed.
- Runs
- Create an Import
- Creates a new import to upload your data into Websets. Imports can be used to: - **Enrich**: Enhance your data with additional information using our AI-powered enrichment engine - **Search**: Query your data using Websets' agentic search with natural language filters - **Exclude**: Prevent duplicate or already known results from appearing in your searches Once the import is created, you can upload your data to the returned `uploadUrl` until `uploadValidUntil` (by default 1 hour).
- Imports
- Delete Import
- Deletes a import.
- Imports
- Get Import
- Gets a specific import.
- Imports
- List Imports
- Lists all imports for the Webset.
- Imports
- Update Import
- Updates a import configuration.
- Imports
- List run events
- List stored events for an Agent run. Set `Accept: text/event-stream` to replay stored events as server-sent events. Use `cursor` for JSON pagination or `Last-Event-ID` for SSE replay.
- Agent
- List runs
- List Agent runs for your team, ordered from newest to oldest.
- Agent
- List Monitors
- Lists all monitors for the authenticated team. Supports filtering by status and cursor-based pagination.
- Monitors
- List Runs
- Lists all runs for a monitor with cursor-based pagination. Runs are returned in reverse chronological order.
- Runs
- Create a Monitor
- Creates a new `Monitor` to continuously keep your Websets updated with fresh data. Monitors automatically run on your defined schedule to ensure your Websets stay current without manual intervention: - **Find new content**: Execute `search` operations to discover fresh items matching your criteria - **Update existing content**: Run `refresh` operations to update items contents and enrichments - **Automated scheduling**: Configure `cron` expressions and `timezone` for precise scheduling control
- Monitors
- Delete Monitor
- Deletes a monitor.
- Monitors
- Get Monitor
- Gets a specific monitor.
- Monitors
- List Monitors
- Lists all monitors for the Webset.
- Monitors
- Get Monitor Run
- Gets a specific monitor run.
- Monitors Runs
- List Monitor Runs
- Lists all runs for the Monitor.
- Monitors Runs
- Update Monitor
- Updates a monitor configuration.
- Monitors
- Search
- Perform a search with an Exa prompt-engineered query and retrieve a list of relevant results. Optionally get contents.
- search
- Get Team Info
- Returns information about the authenticated team, including current concurrency usage and limits.
- Teams
- Trigger a Monitor
- Triggers a run immediately, regardless of the schedule. Works for monitors with status `active` or `paused`.
- Monitors
- Update a Monitor
- Updates an existing monitor. All fields are optional. For `search`, you can send a partial object containing only the fields you want to change. Set `trigger` to `null` to remove the schedule.
- Monitors
- List webhook attempts
- List all attempts made by a Webhook ordered in descending order.
- Webhooks Attempts
- Create a Webhook
- Create a Webhook
- Webhooks
- Delete a Webhook
- Delete a Webhook
- Webhooks
- Get a Webhook
- Get a Webhook
- Webhooks
- List webhooks
- List webhooks
- Webhooks
- Update a Webhook
- Update a Webhook
- Webhooks
- Cancel a running Webset
- Cancels all operations being performed on a Webset. Any enrichment or search will be stopped and the Webset will be marked as `idle`.
- Websets
- Create a Webset
- Creates a new Webset with optional search, import, and enrichment configurations. The Webset will automatically begin processing once created. You can specify an `externalId` to reference the Webset with your own identifiers for easier integration.
- Websets
- Delete a Webset
- Deletes a Webset. Once deleted, the Webset and all its Items will no longer be available.
- Websets
- Cancel a running Enrichment
- All running enrichments will be canceled. You can not resume an Enrichment after it has been canceled.
- Enrichments
- Create an Enrichment
- Create an Enrichment for a Webset.
- Enrichments
- Delete an Enrichment
- When deleting an Enrichment, any running enrichments will be canceled and all existing `enrichment_result` generated by this Enrichment will no longer be available.
- Enrichments
- Get an Enrichment
- Get an Enrichment
- Enrichments
- Update an Enrichment
- Update an Enrichment configuration for a Webset.
- Enrichments
- Get a Webset
- Get a Webset
- Websets
- Delete an Item
- Deletes an Item from the Webset. This will cancel any enrichment process for it.
- Items
- Get an Item
- Returns a Webset Item.
- Items
- List all Items for a Webset
- Returns a list of Webset Items. You can paginate through the Items using the `cursor` parameter.
- Items
- List all Websets
- Returns a list of Websets. You can paginate through the results using the `cursor` parameter. You can filter results using the `search` parameter to find Websets by ID, external ID, or title.
- Websets
- Preview a webset
- Preview how a search query will be decomposed before creating a webset. This endpoint performs the same query analysis that happens during webset creation, allowing you to see the detected entity type, generated search criteria, and available enrichment columns in advance. Use this to help users understand how their search will be interpreted before committing to a full webset creation.
- Websets Preview
- Cancel a running Search
- Cancels a currently running Search. You can cancel all searches at once by using the `websets/:webset/cancel` endpoint.
- Searches
- Create a Search
- Creates a new Search for the Webset. The default behavior is to reuse the previous Search results and evaluate them against the new criteria.
- Searches
- Get a Search
- Gets a Search by id
- Searches
- Update a Webset
- Update a Webset
- Websets
FAQ
Exa integration, answered
- How do AI agents use Exa through Open Connector?
- Your user connects Exa once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes Exa tools to your agent over MCP or a typed API, with credentials injected server-side on each call.
- Is this a Exa MCP server?
- Yes. Open Connector can serve Exa as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call Exa actions with credentials injected server-side.
- Where do Exa credentials live?
- In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.
Give your agents Exa — keep the keys.
Open source, self-hostable, with Exa credentials that never leave your infrastructure. Run it from source today.