MCP server & CLI

The tools and settings of Relvo’s MCP servers, and the @relvo/cli command line.

Hosted and local servers

The hosted server at https://app.relvo.si/mcp speaks Streamable HTTP: sign in with OAuth, or send Authorization: Bearer rlv_…. The local server, npx --yes @relvo/mcp, runs over stdio on Node.js 22 or later and reads RELVO_API_URL and RELVO_API_KEY.

The CLI setup in Connect an agent registers the local server for Claude Code and Codex, so you do not install it separately.

MCP tools

By default the server exposes a small set of tools and loads schemas on demand:

MCP tools

platform_tools
  Find tools for one capability, or up to 4 at once, with prices and schemas. Counts toward included calls.

platform_run
  Quote, run and wait for a tool in one call, with an idempotency key for recovery.

platform
  Read results, schemas, quotes, runs, triggers, monitors, custom tools and team skills, or call any original operation with operation: "call".

platform_team_write
  Create or change team skills, custom tools, triggers and monitors.

Set RELVO_MCP_MODE=full on the local server to list every operation as its own tool. To add up to 20 catalog tools as MCP tools of their own, use ?tools=web_search,serp_lookup on the hosted URL or RELVO_MCP_TOOLS=web_search,serp_lookup locally.

Local server settings

Environment variables

RELVO_API_URL
  The Relvo API URL (https://api.relvo.si). Required.

RELVO_API_KEY
  Your API key. Required.

RELVO_MCP_MODE
  agent (default) or full.

RELVO_MCP_TOOLS
  Up to 20 catalog tools to list directly (agent mode only).

RELVO_MCP_ALLOWED_UPLOAD_ROOTS
  Absolute directories the server may upload files from. Uploads are off by default.

RELVO_RESULT_DIRECTORY
  Where results requested as files are written. Defaults to ./.relvo/results.

RELVO_AUTO_UPDATE
  0 turns off the notice about new versions.

Results and errors

A successful result carries the JSON as text and as structuredContent. A failure returns isError: true; API errors carry error.code and error.message in structuredContent. An ordinary wait timeout is not an error.

The hosted server waits up to 25 seconds per call. Resume longer work with platform and operation: "resume".

Install the CLI

The CLI runs with npx on Node.js 22 or later; nothing is installed globally. This command signs in through your browser:

Shell

npx --yes @relvo/cli setup \
  --api-url https://api.relvo.si \
  --console-url https://app.relvo.si \
  --client terminal

Your login is saved in ~/.config/relvo/profile.json with private permissions. When RELVO_API_URL and RELVO_API_KEY are set, the CLI uses them instead of the saved login.

Search, quote and run

Shell

npx --yes @relvo/cli tools --query "web search" --limit 3 --with-schemas
npx --yes @relvo/cli quote web_search '{"query":"content marketing"}'
npx --yes @relvo/cli run web_search '{"query":"content marketing"}' \
  --idempotency-key brief-2026-11-01

Save a unique idempotency key before each purchase. After a lost reply, run the same command with the same key, or resume the run. Pass - or --input-file <path> instead of inline JSON for long arguments.

Commands

setup
  Sign in through the browser and register MCP for your agents.

doctor
  Check your login and MCP registration without paid calls.

project / usage
  Your project and this month's usage.

tools
  Search the catalog (--query, --limit, --with-schemas, price filters).

tool <name>
  One tool's definition.

quote <tool> <json>
  A free quote.

run <tool> <json>
  Quote, buy and wait in one step.

execute / execution / wait / executions / cancel
  Submit, read, wait for or cancel executions.

result
  Read a large result by path.

upload / download
  Upload an input file, or download an artifact.

connections
  Your project's connections.

triggers / monitors / custom-tools
  Manage triggers, monitors and custom tools. Workflows are managed through the HTTP API.

team-skills
  Share skills, agents and rules, and sync everything the project set up (hooks and MCP servers only with --allow-scripts).

skills list|update
  Show or refresh Relvo's agent skills.

update
  Check for and apply CLI updates.

Run npx --yes @relvo/cli help all for every command and flag.

Output and exit codes

Commands print JSON to stdout and write request failures to stderr; setup, doctor and logout print plain text. download prints the saved file’s absolute path, size and SHA-256.

Exit codes

0
  Success.

1
  The execution or the request failed (see stderr).

2
  Invalid arguments.

3
  The work is still running (wait, run, resume or result).

Looking for a specific tool’s inputs and price? Search the catalog