Serveur MCP

Crevio

co.crevio/crevio
Entreprise et opérations Commerce et retail Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Operates Crevio business workflows for products, customers, orders, email, social activity, research, and websites through an API-connected agent.

ask_crevio
Delegate a job to the Crevio agent and wait for the result. The agent works your account through the Crevio API and every connected integration (products, customers, orders, email, socials, sites, research) and replies in `result`. Each job is a full agent run that takes from half a minute to several minutes, so use it for work that needs judgement or writing. To read or change data directly, run_script is much faster. If the run is still going when the wait ends, the reply has wait_timed_out: true — then call wait_for_run with its id and never call ask_crevio again, which would do the job twice. Run ids do not expire, and only the user who started a run can read it.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['message'], 'properties': {'speed': {'enum': ['faster', 'smarter'], 'type': 'string', 'description': 'faster thinks less, for simple jobs where latency matters more than depth; smarter (default) thinks it through.'}, 'message': {'type': 'string', 'maxLength': 10000, 'description': 'What you want done, in natural language, with all the context needed — the agent does not see your conversation.'}, 'approval_mode': {'enum': ['autonomous', 'supervised', 'read_only'], 'type': 'string', 'description': 'autonomous (default) acts without review; supervised pauses in needs_input for your approval before each gated write (pending_approval_ids) and otherwise finishes with its proposal; read_only forbids writes.'}, 'idempotency_key': {'type': 'string', 'maxLength': 255, 'description': 'Always pass one, unique to this request. Retrying with the same key within an hour returns the run the first call started instead of doing the job twice.'}, 'timeout_seconds': {'type': 'integer', 'maximum': 300, 'minimum': 0, 'description': 'How long to wait for the run to finish before returning. Defaults to, and is capped at, 300 s when your client accepts a streamed reply (text/event-stream), 90 s otherwise. The run keeps going when the wait ends first.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'task_id', 'status', 'created_at'], 'properties': {'id': {'type': 'string'}, 'object': {'type': 'string', 'const': 'task_run'}, 'result': {'type': ['string', 'null']}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string'}, 'chat_id': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'task_id': {'type': 'string'}, 'next_step': {'type': 'string'}, 'task_name': {'type': ['string', 'null']}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'error_message': {'type': ['string', 'null']}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'credits_consumed': {'type': 'integer'}, 'pending_approval_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'A task run — one delegated job and what is known about its state.'}
cancel_run
Stop a run that is pending, running, or waiting for input. The run is finalized as failed with 'Cancelled by the caller'.
Destructif Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'A run id (trun_...).'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'task_id', 'status', 'created_at'], 'properties': {'id': {'type': 'string'}, 'object': {'type': 'string', 'const': 'task_run'}, 'result': {'type': ['string', 'null']}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string'}, 'chat_id': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'task_id': {'type': 'string'}, 'next_step': {'type': 'string'}, 'task_name': {'type': ['string', 'null']}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'error_message': {'type': ['string', 'null']}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'credits_consumed': {'type': 'integer'}, 'pending_approval_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'A task run — one delegated job and what is known about its state.'}
cancel_script_run
Cancel a script run that has not started yet. A running script runs to its end or its timeout.
Destructif Accès externe Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'A script run id (srun_...).'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'status', 'calls', 'timeout_seconds', 'created_at'], 'properties': {'id': {'type': 'string'}, 'calls': {'type': 'array', 'items': {'type': 'object', 'required': ['role'], 'properties': {'role': {'type': 'string'}, 'status': {'type': 'integer'}, 'read_only': {'type': 'boolean'}, 'error_code': {'type': 'string'}}}, 'description': 'Every tool call the script made, in order.'}, 'error': {'type': ['string', 'null']}, 'object': {'type': 'string', 'const': 'script_run'}, 'output': {'type': ['string', 'null'], 'description': 'What the script printed (the last 64,000 characters).'}, 'result': {'description': "The script's last expression, as JSON."}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['queued', 'in_progress', 'completed', 'failed', 'cancelled', 'timed_out'], 'type': 'string'}, 'next_step': {'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'timeout_seconds': {'type': 'integer'}}, 'description': "One script run on the account's computer."}
get_chat
Get a chat's title, kind, and latest run.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['chat_id'], 'properties': {'chat_id': {'type': 'string', 'description': "A chat id (aichat_...). A run id works too — it resolves to that run's chat."}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'created_at'], 'properties': {'id': {'type': 'string'}, 'title': {'type': ['string', 'null']}, 'object': {'type': 'string', 'const': 'chat'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'context_type': {'enum': ['general', 'ai_builder', 'customer_support', 'onboarding', None], 'type': ['string', 'null']}, 'latest_run_id': {'type': ['string', 'null']}}, 'description': 'A chat — one conversation with the agent, across however many runs it took.'}
get_run
Fetch a run's current status, summary, pending approvals, and (once settled) the agent's final reply.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'A run id (trun_...).'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'task_id', 'status', 'created_at'], 'properties': {'id': {'type': 'string'}, 'object': {'type': 'string', 'const': 'task_run'}, 'result': {'type': ['string', 'null']}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string'}, 'chat_id': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'task_id': {'type': 'string'}, 'next_step': {'type': 'string'}, 'task_name': {'type': ['string', 'null']}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'error_message': {'type': ['string', 'null']}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'credits_consumed': {'type': 'integer'}, 'pending_approval_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'A task run — one delegated job and what is known about its state.'}
get_script_run
Read a script run's status, and its result once it has finished.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'A script run id (srun_...).'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'status', 'calls', 'timeout_seconds', 'created_at'], 'properties': {'id': {'type': 'string'}, 'calls': {'type': 'array', 'items': {'type': 'object', 'required': ['role'], 'properties': {'role': {'type': 'string'}, 'status': {'type': 'integer'}, 'read_only': {'type': 'boolean'}, 'error_code': {'type': 'string'}}}, 'description': 'Every tool call the script made, in order.'}, 'error': {'type': ['string', 'null']}, 'object': {'type': 'string', 'const': 'script_run'}, 'output': {'type': ['string', 'null'], 'description': 'What the script printed (the last 64,000 characters).'}, 'result': {'description': "The script's last expression, as JSON."}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['queued', 'in_progress', 'completed', 'failed', 'cancelled', 'timed_out'], 'type': 'string'}, 'next_step': {'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'timeout_seconds': {'type': 'integer'}}, 'description': "One script run on the account's computer."}
list_chats
List the account's chats, newest first.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Default 20.'}, 'search': {'type': 'string', 'description': 'Only chats whose title matches.'}, 'ending_before': {'type': 'string', 'description': 'Return the page before this id — the first id from the previous page.'}, 'starting_after': {'type': 'string', 'description': 'Return the page after this id — the last id from the previous page.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'data', 'has_more'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['object', 'id', 'created_at'], 'properties': {'id': {'type': 'string'}, 'title': {'type': ['string', 'null']}, 'object': {'type': 'string', 'const': 'chat'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'context_type': {'enum': ['general', 'ai_builder', 'customer_support', 'onboarding', None], 'type': ['string', 'null']}, 'latest_run_id': {'type': ['string', 'null']}}, 'description': 'A chat — one conversation with the agent, across however many runs it took.'}}, 'object': {'type': 'string', 'const': 'list'}, 'has_more': {'type': 'boolean'}}, 'description': 'A page of chats, newest first.'}
list_integrations
List what a script can call: the Crevio API (crevioApi), Crevio's own tools (platform), and every integration you can use, each as a namespace under `tools`, plus the account's other connected apps and their status. Then list a namespace's functions with list_integration_tools.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'data', 'other_connections'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['namespace', 'kind', 'tool_count'], 'properties': {'kind': {'enum': ['native', 'crevio_api', 'connection', 'public'], 'type': 'string'}, 'label': {'type': ['string', 'null'], 'description': 'Which connected account, when the app is connected more than once or personally.'}, 'namespace': {'type': 'string', 'description': 'The module a script calls it through: tools.<namespace>.<function>.'}, 'tool_count': {'type': 'integer'}}}}, 'object': {'type': 'string', 'const': 'list'}, 'other_connections': {'type': 'array', 'items': {'type': 'object', 'required': ['app', 'status'], 'properties': {'app': {'type': 'string'}, 'label': {'type': ['string', 'null']}, 'status': {'type': 'string'}}}, 'description': 'Connected apps without a namespace of their own: expired ones need reconnecting in Crevio, social accounts are reached through crevioApi, and the rest serve Crevio itself (Slack for chat, GitHub for sites).'}}}
list_integration_tools
List one namespace's functions — the name a script calls, its parameters, whether it only reads, whether it needs approval, and a snippet run_script accepts. crevioApi has hundreds of operations: narrow it with `search`.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['namespace'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Default 10.'}, 'offset': {'type': 'integer', 'minimum': 0, 'description': 'Skip this many matches — the count already seen.'}, 'search': {'type': 'string', 'description': 'Only functions whose name or description matches every word.'}, 'namespace': {'type': 'string', 'description': 'A namespace from list_integrations, e.g. crevioApi or pdGmail.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'data', 'has_more'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'parameters', 'read_only', 'requires_approval', 'disabled', 'snippet'], 'properties': {'name': {'type': 'string', 'description': 'What a script calls: tools.<namespace>.<function>.'}, 'returns': {'type': 'string', 'description': 'What a read resolves to, as a TypeScript type; objects past two levels show as Record<string, unknown>.'}, 'snippet': {'type': 'string', 'description': 'A script run_script accepts as-is once the placeholders are filled.'}, 'disabled': {'type': 'boolean'}, 'read_only': {'type': 'boolean'}, 'parameters': {'type': 'string', 'description': 'The argument object, as a TypeScript type.'}, 'description': {'type': ['string', 'null']}, 'requires_approval': {'type': 'boolean', 'description': 'A script cannot ask for approval, so calling it fails unless the account sets it to run automatically.'}}}}, 'object': {'type': 'string', 'const': 'list'}, 'has_more': {'type': 'boolean'}}}
list_messages
Read a chat's messages, oldest first. Returns the most recent `limit` messages; page back through older ones with starting_after.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['chat_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Default 50.'}, 'chat_id': {'type': 'string', 'description': "A chat id (aichat_...). A run id works too — it resolves to that run's chat."}, 'ending_before': {'type': 'string', 'description': 'Return the messages older than this id — the first id of the previous page. Paging walks backwards through history, since the default page is the tail.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'data', 'has_more'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'role', 'content', 'created_at'], 'properties': {'id': {'type': 'string'}, 'role': {'enum': ['user', 'assistant'], 'type': 'string'}, 'content': {'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}}, 'description': "One message in a run's conversation."}}, 'object': {'type': 'string', 'const': 'list'}, 'has_more': {'type': 'boolean'}}, 'description': 'A page of conversation messages, oldest first.'}
list_runs
List the account's task runs, newest first — delegated jobs and scheduled tasks alike. Filter by status or task.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Default 20.'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string', 'description': 'Only runs in this state.'}, 'task_id': {'type': 'string', 'description': 'Only runs of this task (task_...).'}, 'ending_before': {'type': 'string', 'description': 'Return the page before this id — the first id from the previous page.'}, 'starting_after': {'type': 'string', 'description': 'Return the page after this id — the last id from the previous page.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'data', 'has_more'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['object', 'id', 'task_id', 'status', 'created_at'], 'properties': {'id': {'type': 'string'}, 'object': {'type': 'string', 'const': 'task_run'}, 'result': {'type': ['string', 'null']}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string'}, 'chat_id': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'task_id': {'type': 'string'}, 'next_step': {'type': 'string'}, 'task_name': {'type': ['string', 'null']}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'error_message': {'type': ['string', 'null']}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'credits_consumed': {'type': 'integer'}, 'pending_approval_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'A task run — one delegated job and what is known about its state.'}}, 'object': {'type': 'string', 'const': 'list'}, 'has_more': {'type': 'boolean'}}, 'description': 'A page of task runs, newest first.'}
resolve_approvals
Approve or deny the integration actions a run is paused on (status needs_input with pending_approval_ids). Submit a decision for every pending id at once; the run resumes in the background.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id', 'approvals'], 'properties': {'run_id': {'type': 'string', 'description': 'A run id (trun_...).'}, 'approvals': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'approved'], 'properties': {'id': {'type': 'string', 'description': "A pending approval id from the run's pending_approval_ids."}, 'reason': {'type': 'string', 'description': 'Why it was denied (optional).'}, 'approved': {'type': 'boolean', 'description': 'True to let the action run, false to deny it.'}}}, 'minItems': 1, 'description': 'One decision per pending approval id — the run stays paused until every one is answered.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'task_id', 'status', 'created_at'], 'properties': {'id': {'type': 'string'}, 'object': {'type': 'string', 'const': 'task_run'}, 'result': {'type': ['string', 'null']}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string'}, 'chat_id': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'task_id': {'type': 'string'}, 'next_step': {'type': 'string'}, 'task_name': {'type': ['string', 'null']}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'error_message': {'type': ['string', 'null']}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'credits_consumed': {'type': 'integer'}, 'pending_approval_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'A task run — one delegated job and what is known about its state.'}
run_script
Run JavaScript on the account's computer with bun — no agent turn — and wait for its result. `tools.<namespace>.<function>(args)` calls anything list_integration_tools shows (every call returns its result and throws on failure; top-level await works), and the script's last expression is its result. Chain calls and transform data in one run, e.g. `const { data } = await tools.crevioApi.listOrders({ status: "succeeded" }); data.length`. Runs as you, and only for account admins. If the wait ends first the reply has wait_timed_out: true and the run id: continue with wait_for_script_run — calling run_script again runs it twice unless you reuse the idempotency_key. Run ids do not expire, and only the user who started a run can read it. At most 4 runs in flight per user.
Destructif Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['code'], 'properties': {'code': {'type': 'string', 'maxLength': 100000, 'description': 'The JavaScript to run.'}, 'wait_seconds': {'type': 'integer', 'maximum': 300, 'minimum': 0, 'description': 'How long to wait for the script to finish before returning. Defaults to, and is capped at, 300 s when your client accepts a streamed reply (text/event-stream), 90 s otherwise. The script keeps going when the wait ends first.'}, 'idempotency_key': {'type': 'string', 'maxLength': 255, 'description': 'Always pass one, unique to this request. Retrying with the same key within an hour returns the run the first call started instead of doing the job twice.'}, 'timeout_seconds': {'type': 'integer', 'maximum': 600, 'minimum': 1, 'description': 'How long the script may run (default 300).'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'status', 'calls', 'timeout_seconds', 'created_at'], 'properties': {'id': {'type': 'string'}, 'calls': {'type': 'array', 'items': {'type': 'object', 'required': ['role'], 'properties': {'role': {'type': 'string'}, 'status': {'type': 'integer'}, 'read_only': {'type': 'boolean'}, 'error_code': {'type': 'string'}}}, 'description': 'Every tool call the script made, in order.'}, 'error': {'type': ['string', 'null']}, 'object': {'type': 'string', 'const': 'script_run'}, 'output': {'type': ['string', 'null'], 'description': 'What the script printed (the last 64,000 characters).'}, 'result': {'description': "The script's last expression, as JSON."}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['queued', 'in_progress', 'completed', 'failed', 'cancelled', 'timed_out'], 'type': 'string'}, 'next_step': {'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'timeout_seconds': {'type': 'integer'}}, 'description': "One script run on the account's computer."}
send_message
Continue a chat with follow-up instructions or answers — the agent keeps its context. Resumes a run waiting in needs_input, or queues a new run when the last one finished. Returns run_busy while a run is still in progress. Optionally waits for the reply.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['chat_id', 'message'], 'properties': {'chat_id': {'type': 'string', 'description': "A chat id (aichat_...). A run id works too — it resolves to that run's chat."}, 'message': {'type': 'string', 'maxLength': 10000, 'description': 'The follow-up to send into the conversation.'}, 'timeout_seconds': {'type': 'integer', 'maximum': 300, 'minimum': 0, 'description': "Seconds to wait for the reply before returning (default 0: return the new run immediately). Capped like ask_crevio's wait."}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'task_id', 'status', 'created_at'], 'properties': {'id': {'type': 'string'}, 'object': {'type': 'string', 'const': 'task_run'}, 'result': {'type': ['string', 'null']}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string'}, 'chat_id': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'task_id': {'type': 'string'}, 'next_step': {'type': 'string'}, 'task_name': {'type': ['string', 'null']}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'error_message': {'type': ['string', 'null']}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'credits_consumed': {'type': 'integer'}, 'pending_approval_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'A task run — one delegated job and what is known about its state.'}
start_chat
Open a chat with the Crevio agent and queue a run, without waiting. Returns the run immediately — its `chat_id` is the conversation to continue with send_message. Follow the run with wait_for_run or get_run.
Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['message'], 'properties': {'speed': {'enum': ['faster', 'smarter'], 'type': 'string', 'description': 'faster thinks less, for simple jobs where latency matters more than depth; smarter (default) thinks it through.'}, 'message': {'type': 'string', 'maxLength': 10000, 'description': 'What you want done, in natural language, with all the context needed — the agent does not see your conversation.'}, 'approval_mode': {'enum': ['autonomous', 'supervised', 'read_only'], 'type': 'string', 'description': 'autonomous (default) acts without review; supervised pauses in needs_input for your approval before each gated write (pending_approval_ids) and otherwise finishes with its proposal; read_only forbids writes.'}, 'idempotency_key': {'type': 'string', 'maxLength': 255, 'description': 'Always pass one, unique to this request. Retrying with the same key within an hour returns the run the first call started instead of doing the job twice.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'task_id', 'status', 'created_at'], 'properties': {'id': {'type': 'string'}, 'object': {'type': 'string', 'const': 'task_run'}, 'result': {'type': ['string', 'null']}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string'}, 'chat_id': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'task_id': {'type': 'string'}, 'next_step': {'type': 'string'}, 'task_name': {'type': ['string', 'null']}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'error_message': {'type': ['string', 'null']}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'credits_consumed': {'type': 'integer'}, 'pending_approval_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'A task run — one delegated job and what is known about its state.'}
wait_for_run
Wait for a run to settle (completed, failed, or needs_input) and return it with the agent's final reply. If it is still running when the wait ends, the reply has wait_timed_out: true — call wait_for_run again.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'A run id (trun_...).'}, 'timeout_seconds': {'type': 'integer', 'maximum': 300, 'minimum': 0, 'description': 'How long to wait for the run to finish before returning. Defaults to, and is capped at, 300 s when your client accepts a streamed reply (text/event-stream), 90 s otherwise. The run keeps going when the wait ends first.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'task_id', 'status', 'created_at'], 'properties': {'id': {'type': 'string'}, 'object': {'type': 'string', 'const': 'task_run'}, 'result': {'type': ['string', 'null']}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['pending', 'running', 'completed', 'failed', 'needs_input', 'timed_out', 'unknown', 'skipped'], 'type': 'string'}, 'chat_id': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'task_id': {'type': 'string'}, 'next_step': {'type': 'string'}, 'task_name': {'type': ['string', 'null']}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'error_message': {'type': ['string', 'null']}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'credits_consumed': {'type': 'integer'}, 'pending_approval_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'description': 'A task run — one delegated job and what is known about its state.'}
wait_for_script_run
Wait for a script run to finish and return its result. If it is still running when the wait ends, the reply has wait_timed_out: true — call again.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'A script run id (srun_...).'}, 'wait_seconds': {'type': 'integer', 'maximum': 300, 'minimum': 0, 'description': 'How long to wait for the script to finish before returning. Defaults to, and is capped at, 300 s when your client accepts a streamed reply (text/event-stream), 90 s otherwise. The script keeps going when the wait ends first.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'id', 'status', 'calls', 'timeout_seconds', 'created_at'], 'properties': {'id': {'type': 'string'}, 'calls': {'type': 'array', 'items': {'type': 'object', 'required': ['role'], 'properties': {'role': {'type': 'string'}, 'status': {'type': 'integer'}, 'read_only': {'type': 'boolean'}, 'error_code': {'type': 'string'}}}, 'description': 'Every tool call the script made, in order.'}, 'error': {'type': ['string', 'null']}, 'object': {'type': 'string', 'const': 'script_run'}, 'output': {'type': ['string', 'null'], 'description': 'What the script printed (the last 64,000 characters).'}, 'result': {'description': "The script's last expression, as JSON."}, 'reused': {'type': 'boolean'}, 'status': {'enum': ['queued', 'in_progress', 'completed', 'failed', 'cancelled', 'timed_out'], 'type': 'string'}, 'next_step': {'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'started_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'completed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'wait_timed_out': {'type': 'boolean', 'description': 'The wait ended first. The work is still running: follow it with the tool next_step names.'}, 'timeout_seconds': {'type': 'integer'}}, 'description': "One script run on the account's computer."}
whoami
Identify the account, user, and credential behind this connection, with plan, credit balance, rate limits, and the tools available. Only needed to troubleshoot the connection or check credits and limits — other tools already act on this account.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['object', 'account', 'credential', 'plan', 'credits', 'tools'], 'properties': {'plan': {'type': 'string'}, 'user': {'type': ['object', 'null'], 'required': ['id', 'email'], 'properties': {'id': {'type': 'string'}, 'name': {'type': ['string', 'null']}, 'email': {'type': 'string'}}}, 'tools': {'type': 'array', 'items': {'type': 'string'}}, 'limits': {'type': 'object', 'required': ['ask_timeout_default_seconds', 'ask_timeout_max_seconds', 'message_max_chars'], 'properties': {'message_max_chars': {'type': 'integer'}, 'ask_timeout_max_seconds': {'type': 'integer', 'description': 'Longer when this connection accepts a streamed reply.'}, 'ask_timeout_default_seconds': {'type': 'integer'}}, 'description': 'Bounds the delegation tools enforce.'}, 'object': {'type': 'string', 'const': 'whoami'}, 'account': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': ['string', 'null']}}, 'description': 'The account every tool call is scoped to.'}, 'credits': {'type': 'number'}, 'credential': {'type': 'object', 'required': ['type'], 'properties': {'id': {'type': 'string'}, 'name': {'type': ['string', 'null']}, 'type': {'enum': ['api_key', 'oauth'], 'type': 'string'}, 'expires_at': {'type': ['string', 'null'], 'format': 'date-time'}}, 'description': 'How this connection authenticated.'}, 'rate_limit': {'type': 'object', 'required': ['limit', 'window_seconds'], 'properties': {'limit': {'type': 'integer'}, 'window_seconds': {'type': 'integer'}}, 'description': 'The API rate limit this credential is subject to.'}}, 'description': 'The account, user, and credential behind this connection, with the limits that apply to it.'}
Supprimé
api_search
1 October 2026 02:52
Supprimé
api_execute
1 October 2026 02:52
Modifié
cancel_run
1 October 2026 02:52
Modifié
resolve_approvals
1 October 2026 02:52
Modifié
list_runs
1 October 2026 02:52
Modifié
get_run
1 October 2026 02:52
Modifié
wait_for_run
1 October 2026 02:52
Modifié
list_messages
1 October 2026 02:52
Modifié
send_message
1 October 2026 02:52
Modifié
get_chat
1 October 2026 02:52
Modifié
list_chats
1 October 2026 02:52
Modifié
start_chat
1 October 2026 02:52
Modifié
ask_crevio
1 October 2026 02:52
Ajouté
cancel_script_run
1 October 2026 02:52
Ajouté
get_script_run
1 October 2026 02:52
Ajouté
wait_for_script_run
1 October 2026 02:52
Ajouté
run_script
1 October 2026 02:52
Ajouté
list_integration_tools
1 October 2026 02:52
Ajouté
list_integrations
1 October 2026 02:52
Modifié
whoami
1 October 2026 02:52
Modifié
api_execute
25 September 2026 03:01
Modifié
cancel_run
25 September 2026 03:01
Modifié
resolve_approvals
25 September 2026 03:01
Modifié
list_runs
25 September 2026 03:01
Modifié
get_run
25 September 2026 03:01
Modifié
wait_for_run
25 September 2026 03:01
Modifié
send_message
25 September 2026 03:01
Modifié
start_chat
25 September 2026 03:01
Modifié
ask_crevio
25 September 2026 03:01
Ajouté
api_execute
17 September 2026 07:58