Servidor MCP

Crevio

co.crevio/crevio
Negocio y operaciones Comercio y retail Público y accesible MCP 2025-11-25

Qué hace este 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.
Acceso externo
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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'.
Destructivo Acceso externo Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'A run id (trun_...).'}}}
Esquema de salida
{'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.
Destructivo Acceso externo Idempotente
Esquema de entrada
{'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_...).'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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."}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['run_id'], 'properties': {'run_id': {'type': 'string', 'description': 'A run id (trun_...).'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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_...).'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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`.
Solo lectura Idempotente
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Destructivo Acceso externo
Esquema de entrada
{'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).'}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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."}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.'}
Eliminado
api_search
1 de October de 2026 a las 02:52
Eliminado
api_execute
1 de October de 2026 a las 02:52
Modificado
cancel_run
1 de October de 2026 a las 02:52
Modificado
resolve_approvals
1 de October de 2026 a las 02:52
Modificado
list_runs
1 de October de 2026 a las 02:52
Modificado
get_run
1 de October de 2026 a las 02:52
Modificado
wait_for_run
1 de October de 2026 a las 02:52
Modificado
list_messages
1 de October de 2026 a las 02:52
Modificado
send_message
1 de October de 2026 a las 02:52
Modificado
get_chat
1 de October de 2026 a las 02:52
Modificado
list_chats
1 de October de 2026 a las 02:52
Modificado
start_chat
1 de October de 2026 a las 02:52
Modificado
ask_crevio
1 de October de 2026 a las 02:52
Añadido
cancel_script_run
1 de October de 2026 a las 02:52
Añadido
get_script_run
1 de October de 2026 a las 02:52
Añadido
wait_for_script_run
1 de October de 2026 a las 02:52
Añadido
run_script
1 de October de 2026 a las 02:52
Añadido
list_integration_tools
1 de October de 2026 a las 02:52
Añadido
list_integrations
1 de October de 2026 a las 02:52
Modificado
whoami
1 de October de 2026 a las 02:52
Modificado
api_execute
25 de September de 2026 a las 03:01
Modificado
cancel_run
25 de September de 2026 a las 03:01
Modificado
resolve_approvals
25 de September de 2026 a las 03:01
Modificado
list_runs
25 de September de 2026 a las 03:01
Modificado
get_run
25 de September de 2026 a las 03:01
Modificado
wait_for_run
25 de September de 2026 a las 03:01
Modificado
send_message
25 de September de 2026 a las 03:01
Modificado
start_chat
25 de September de 2026 a las 03:01
Modificado
ask_crevio
25 de September de 2026 a las 03:01
Añadido
api_execute
17 de September de 2026 a las 07:58