Tools
Canonical fourteen-tool reference for Everyn hosted MCP V1.
The public production MCP endpoint is live at https://mcp.everyn.ai/mcp. Configure a host with that Streamable HTTP URL and complete WorkOS OAuth.
Use these fourteen tools only. Annotations are accurate but advisory. Custom hints such as write and cost-bearing live on tool _meta as io.everyn/* because official MCP annotations are a closed four-hint model.
Every successful tool result includes next_action and a concise text fallback that never includes signed descriptors.
Catalog
| Tool | Title | Read-only | Destructive | Cost-bearing |
|---|---|---|---|---|
get_context | Get current Everyn context | Yes | No | No |
upload_csv | Upload a CSV Dataset | No | No | No |
search_datasets | Search Datasets | Yes | No | No |
get_dataset | Get one Dataset | Yes | No | No |
search_jobs | Search Jobs | Yes | No | No |
get_job | Get one Job | Yes | No | No |
save_job | Create or patch a Job | No | No | No |
search_runs | Search Runs | Yes | No | No |
start_run | Start, resume, or retry a Run | No | No | Yes |
get_run | Get Run status or wait | Yes | No | No |
cancel_run | Cancel a Run | No | Yes | No |
get_run_results | Preview committed Run results | Yes | No | No |
export_run | Export complete results | No | No | No |
search_docs | Search published Everyn docs | Yes | No | No |
Tool notes
get_context
Return compact identity and workspace orientation for the authenticated current organization only. Optional include sections are identity, plan, usage, funding, models, capabilities, and uploads. Sections return available/data/handoff and never fabricate plan or billing values. Callers cannot select another user or organization.
upload_csv
Issue or refresh a constrained hosted transfer ticket, observe intake, or return the Datasets-page fallback when the client cannot move local bytes. See Datasets.
search_datasets
Query or list recent accessible Datasets through bounded receipts. Omitted query lists recent Datasets. Rows and full profiles never appear in search results.
get_dataset
Inspect one Dataset's metadata, schema/profile, representative rows, and readiness. Never returns the complete CSV.
search_jobs
Query or list recent reusable Jobs through bounded receipts. Omitted query lists recent Jobs.
get_job
Read one Job's current or explicitly selected immutable version, including instructions, output contract, exact model, capabilities, display fields, and compact Run history.
save_job
Create a complete reusable Job or append an exact-base immutable patch revision. Successful receipts return the stable Job ID, exact version ID, and complete effective definition. See Jobs.
search_runs
Filter or list recent Runs through bounded progress and lifecycle receipts. Does not invent free-text Run search.
start_run
Start exactly one new sample or full Run, resume one eligible paused Run, or create and start one immutable retry over Everyn-derived eligible scope. See Runs.
get_run
Return immediate status or perform one bounded wait for change, attention, or terminal. Disconnect ends only the waiter. export_and_analyze is offered only when the resolved completion set is terminal and version-compatible.
cancel_run
Cancel one Run with harvest-aware semantics. Harvest failure never blocks cancellation. Urgent stop cancels first. Canceled Runs cannot resume. Repeated cancel is safe.
get_run_results
Return a small committed preview with explicit incompleteness. Never paginate exhaustively or create a CSV. Active Runs always report incomplete.
export_run
Create or reconnect to the complete terminal CSV export and return a refreshable HTTPS delivery descriptor. No second user approval after an authorized Run. See Export.
search_docs
Search only the published Everyn Docs and Help corpus and return bounded localized excerpts and canonical URLs. Never indexes repository-private planning, runbooks, credentials, or company knowledge.