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
- Find the action in the table below, or call
search_one_platform_actions with platform exa if it is not listed.
- 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.
- 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.