exa

name

exa

description

Exa is a semantic search engine built to help users find high-quality, insightful content from across the web. It focuses on meaning-based search rather than just keyword matching. Read and write Exa data through One: monitors, websets, agentruns, websetenrichments, imports, apikeys and more, 66 actions with real parameter documentation. Use whenever the user asks to look something up in Exa, create or update a record there, or build code against the Exa API.

Exa through One

Exa is a semantic search engine built to help users find high-quality, insightful content from across the web. It focuses on meaning-based search rather than just keyword matching.

One exposes Exa through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform exa if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Exa is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Exa account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Monitors

Action	Method	Path	Action id
Get a Monitor	GET	/monitors/{{id}}	conn_mod_def::GLnP1ol87qY::BE6wL1D9SlCm-GxdeBOtmQ
Get Monitor	GET	/v0/monitors/{{id}}	conn_mod_def::GLnP1vFKpio::lMVix-qBQ0G4ZPJvDZA63w
List Monitors	GET	/v0/monitors	conn_mod_def::GLnP1vNbCsU::8xnN0iGlSt-uzsBS0PjoPg
List Monitors	GET	/monitors	conn_mod_def::GLnP1v0wbpg::0LT8DJSGRny5OvjeMV2Y1A
Batch Action on Monitors	POST	/monitors/batch	conn_mod_def::GLnP1hgAxxI::T18x5LQfShuv_V6jjeoGow
Create a Monitor	POST	/v0/monitors	conn_mod_def::GLnP1ojhia8::JWuE7IHBT8GujLiIzQWyCQ
Create a Monitor	POST	/monitors	conn_mod_def::GLnP1o26Hso::gNs6IKgiQmqKlI5LYsfdhw
Delete a Monitor	DELETE	/monitors/{{id}}	conn_mod_def::GLnP1n8Z5IY::_dagZjc4QXymL0xz9Z2iAQ
Delete Monitor	DELETE	/v0/monitors/{{id}}	conn_mod_def::GLnP1pMjZ9E::5OFP8LxfQD-Izt74ZuYrZg
Trigger a Monitor	POST	/monitors/{{id}}/trigger	conn_mod_def::GLnP1u6EfG0::ENFViho5RjCv0ipsRfqmog
Update a Monitor	PATCH	/monitors/{{id}}	conn_mod_def::GLnP1vVAQc8::iI3h_YjuRY6OBg9mBnI9aw
Update a Monitor	PATCH	/v0/monitors/{{id}}	conn_mod_def::GLnP13YxBmU::X3S9SWgdSpOxFkoJ6OsI-A

Websets

Action	Method	Path	Action id
Get a Webset	GET	/v0/websets/{{id}}	conn_mod_def::GLnP3_ylDog::9gJRU45TTguUobKrTkvMLA
List Websets	GET	/v0/websets	conn_mod_def::GLnP3_Neh5Q::2Kj-r2l7TNm2is-NTvSEAw
Cancel a Webset	POST	/v0/websets/{{id}}/cancel	conn_mod_def::GLnP3tBe-dw::GlGhhY1yQiy1Drs3YifMDQ
Create a Webset	POST	/v0/websets	conn_mod_def::GLnP3_DQW_4::5ZNc91ZbS5WaIH4F6f3CFQ
Delete Webset	DELETE	/v0/websets/{{id}}	conn_mod_def::GLnP4K7EjyM::0-FE7cPzQveC_Q4TCBTneg
Preview a Webset	POST	/v0/websets/preview	conn_mod_def::GLnP4Ro7w3Q::tfjc6wyLQ72nP4-_FYvAgA
Update a Webset	POST	/v0/websets/{{id}}	conn_mod_def::GLnP3-zl3uk::EZhnpC2aRIm3kepbhtcD_w

AgentRuns

Action	Method	Path	Action id
Get a Run Using Agent Runs	GET	/agent/runs/{{id}}	conn_mod_def::GLnP0wU8NnU::zg3JAhGNRcWxak__12aVBw
List Agent Runs	GET	/agent/runs	conn_mod_def::GLnP09ZFptQ::ZDgTp01aTa2prCZp5r9ECQ
Cancel an Agent Run	POST	/agent/runs/{{id}}/cancel	conn_mod_def::GLnP0wISw4s::q5hcQJScTHCV7mpcj0BGZg
Create Agent Runs	POST	/agent/runs	conn_mod_def::GLnP0yCt19M::bLO1qm5cTZysCgl3QaoDyQ
Delete an Agent Run	DELETE	/agent/runs/{{id}}	conn_mod_def::GLnP0wpcaXs::YjuNVE_nSzCQUXBL-4deUw

WebsetEnrichments

Action	Method	Path	Action id
Get a Webset Enrichment	GET	/v0/websets/{{webset}}/enrichments/{{id}}	conn_mod_def::GLnP1Mm1hS8::r6EHPvprSumYm0nK7-J-WQ
Cancel a Webset Enrichment	POST	/v0/websets/{{webset}}/enrichments/{{id}}/cancel	conn_mod_def::GLnP0_Iow40::lcZX86jtRrO1rUfaaurWnw
Create an Enrichment for a Webset	POST	/v0/websets/{{webset}}/enrichments	conn_mod_def::GLnP09oKk6k::UI9GHjtaTvuTT8_CaWP5AQ
Delete a Webset Enrichment	DELETE	/v0/websets/{{webset}}/enrichments/{{id}}	conn_mod_def::GLnP09sQBi4::FrL1dBsLRd-1ujNOdE2vwA
Update an Enrichment for a Webset	PATCH	/v0/websets/{{webset}}/enrichments/{{id}}	conn_mod_def::GLnP1TUSUpM::9_mWTS8LS9y9lc8xGV-8fg

Imports

Action	Method	Path	Action id
Get an Import	GET	/v0/imports/{{id}}	conn_mod_def::GLnP1Z8l7-U::oxXE12RIT32i6qE9CcVFoQ
List Imports	GET	/v0/imports	conn_mod_def::GLnP1Ze7mHw::00kZloxIQ_Wj4eVaJxCrfQ
Create an Import	POST	/v0/imports	conn_mod_def::GLnP1Zl1Dxc::alVFUPN6SRmX4Zy1OQ8img
Delete Import	DELETE	/v0/imports/{{id}}	conn_mod_def::GLnP1Zc8lYg::rfV57P32SZCTQp7ZI0HRHA
Update an Import	PATCH	/v0/imports/{{id}}	conn_mod_def::GLnP1hlkDtI::it_W_zMJQ3aPVgjzx26t8g

ApiKeys

Action	Method	Path	Action id
Get API Key	GET	/team-management/api-keys/{{id}}	conn_mod_def::GLnP3X6djks::8HLxF50-QbWvkPxPzAhWfw
List API Keys	GET	/team-management/api-keys	conn_mod_def::GLnP3dzVH54::YCeiRSI4TlaQu6N8-UoXNw
Create API Key for a Team	POST	/team-management/api-keys	conn_mod_def::GLnP3IHwCUw::687SYBv8TBS7KakREOTjlw
Delete an API Key	DELETE	/team-management/api-keys/{{id}}	conn_mod_def::GLnP3K4L0AI::-1iVuHcvT4u-AfpQqQxBmg
Update an API Key	PUT	/team-management/api-keys/{{id}}	conn_mod_def::GLnP3eM4nNg::AE3bzv4xT2e0GCVphCFC3A

Webhooks

Action	Method	Path	Action id
Get a Webhook	GET	/v0/webhooks/{{id}}	conn_mod_def::GLnP3ptGPTc::eMDm5IcVQa6h1P1a5cK0mQ
List Webhooks	GET	/v0/webhooks	conn_mod_def::GLnP3qQRU5Y::MYHFyTG5Ti2zn1K7k8ybtA
Create a Webhook	POST	/v0/webhooks	conn_mod_def::GLnP3d4721U::fnUetBLjQ62d9ahBHquczQ
Delete a Webhook	DELETE	/v0/webhooks/{{id}}	conn_mod_def::GLnP3gUnpx0::PPKRC3-tT3C32aJYfhG9Xw
Update a Webhook	PATCH	/v0/webhooks/{{id}}	conn_mod_def::GLnP3pchO2M::ph_EwDIFQDK0bkMx2G2nzQ

MonitorRuns

Action	Method	Path	Action id
Get a Monitor Run	GET	/v0/monitors/{{monitor}}/runs/{{id}}	conn_mod_def::GLnP2HLDUAs::ncuw1EExRZuoloWbCPIHkQ
Get a Monitor Run	GET	/monitors/{{id}}/runs/{{runId}}	conn_mod_def::GLnP2O4fGoQ::8E1BHk6yT1e4oLiVjtvDoQ
List a Monitor's Runs	GET	/monitors/{{id}}/runs	conn_mod_def::GLnP3CJzKLo::nbYKoop-RUad-yxP2npcKA
List Monitor Runs for a Monitor	GET	/v0/monitors/{{monitor}}/runs	conn_mod_def::GLnP14ZarR0::KTMmiiaSQ4WtFuYjvU6cpA

Events

Action	Method	Path	Action id
Get an Event	GET	/v0/events/{{id}}	conn_mod_def::GLnP1TnZJ1U::xdF1F6YJTyyIKVuUsUD4Qw
List Events	GET	/v0/events	conn_mod_def::GLnP1S_GuQs::657y61dTR3SLXxqzPFiAMQ

WebsetItems

Action	Method	Path	Action id
Get a Webset Item	GET	/v0/websets/{{webset}}/items/{{id}}	conn_mod_def::GLnP1hWVReU::D7rLq8SIQ-Kzu2Uspt9gAQ
List All Items for a Webset	GET	/v0/websets/{{webset}}/items	conn_mod_def::GLnP1ir2EXk::l371VNWbQnG3JZjeRREn9g

Research

Action	Method	Path	Action id
Get Research by ID	GET	/research/v1/{{researchId}}	conn_mod_def::GLnP13k5c4A::ZpTlsScmTIqclinV5lv3Fg
Create Research Request Using Research v1	POST	/research/v1	conn_mod_def::GLnP13gMMp8::aNBnjGiaTHKa2mZSOTUnPA

WebsetSearches

Action	Method	Path	Action id
Cancel a Webset Search	POST	/v0/websets/{{webset}}/searches/{{id}}/cancel	conn_mod_def::GLnP2OKDHSk::0VPelgzyTZmtoavZz9Ux7g
Create a Webset Search	POST	/v0/websets/{{webset}}/searches	conn_mod_def::GLnP2OmQlnk::xWRMlxuMTfe1Z2XLYfoDjg

AgentRunEvents

Action	Method	Path	Action id
List an Agent Run's Events	GET	/agent/runs/{{id}}/events	conn_mod_def::GLnP0363pbk::uIQWpx4UR5yc6A2NwOq0tg

Contents

Action	Method	Path	Action id
Get Contents	POST	/contents	conn_mod_def::GLnP1SliTjU::cHYbAszDQvC4kJVefjxTMw

Answer

Action	Method	Path	Action id
Answer	POST	/answer	conn_mod_def::GLnP1TDvmxk::ItLr_xMCQiuhFUUNWXBhIQ

Search

Action	Method	Path	Action id
Search	POST	/search	conn_mod_def::GLnP1aajcpM::B9YzjETpQGWIsmbugYJXJQ

WebsetItem

Action	Method	Path	Action id
Delete a Webset Item	DELETE	/v0/websets/{{webset}}/items/{{id}}	conn_mod_def::GLnP1h02T90::CSFp3HZ7TgmAVM2LPXQdbg

ResearchRequests

Action	Method	Path	Action id
List Research Requests	GET	/research/v1	conn_mod_def::GLnP2Pt5j9k::86JwzTIZR1OYNapcXeKwDg

WebsetSearch

Action	Method	Path	Action id
Get a Webset Search by ID	GET	/v0/websets/{{webset}}/searches/{{id}}	conn_mod_def::GLnP3KQQPqg::dY30H_1_QrW-Z2MgHcnCZA

ApiKeyUsage

Action	Method	Path	Action id
Get API Key Usage	GET	/team-management/api-keys/{{id}}/usage	conn_mod_def::GLnP3ONIWf4::FXKriz47RJGPkaM517qrJA

Teams

Action	Method	Path	Action id
Get Team Info	GET	/v0/teams/me	conn_mod_def::GLnP3i_kitE::7Okn3iieRniq-_Du7NjiOg

WebhookAttempts

Action	Method	Path	Action id
List Webhook Attempts for a Webhook	GET	/v0/webhooks/{{id}}/attempts	conn_mod_def::GLnP34U7BTg::IbkYFX3EREKmcqiaqJYNRA

When a call fails

The error comes from Exa, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/exa

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.