Relvo MCP

Connect an MCP host to Relvo tools. This package runs a local stdio server and requires Node.js 22+.

Connect

Claude Code or Codex: use Relvo setup. The CLI setup command registers its bundled MCP server and saves your login privately; you do not need this standalone package as well.

Other local MCP hosts: add this configuration, using the API URL and developer key shown in your Relvo console:

{
  "mcpServers": {
    "relvo": {
      "command": "npx",
      "args": ["--yes", "@relvo/mcp"],
      "env": {
        "RELVO_API_URL": "https://YOUR_RELVO_API_URL",
        "RELVO_API_KEY": "YOUR_DEVELOPER_API_KEY"
      }
    }
  }
}

Both environment variables are required. Keep the key private and out of Git. Restart the host after changing its configuration.

Hosts with remote MCP support: connect to https://app.relvo.si/mcp and sign in through your browser. This option does not require a local npm package.

First check

Ask your agent to check the Relvo connection without running a paid tool. By default, the server exposes four tools:

| Tool | Purpose | | --- | --- | | platform_tools | Find capabilities and their input schemas. | | platform_run | Quote and run approved work, then wait for the result. | | platform | Inspect schemas, get quotes, read results, or resume a run. | | platform_team_write | Create or change what the whole team shares: skills, custom tools, triggers and monitors. |

For a price-only check, use platform to call platform_quote before any run. Schemas load on demand. Set RELVO_MCP_MODE=full only if your host needs every original operation listed as a separate tool.

Team skill references

Use platform with operation team_skills to list your team's procedures. Operation team_skill reads one by slug and lists its files. Add a relative path to read SKILL.md, a reference document, an image or a script. Images return MCP image content; long text and binary files return pages with nextOffset. The same access permissions apply to every file.

For local folder installation, use Use in your environment in Customize → Skills.

With a managed local login, platform_projects lists approved projects and platform_project_select selects the next connection's project. Selection deactivates old managed files and archives edits, then asks you to reconnect/start a fresh agent session. It does not install the target project's files. platform_project_sync reviews and imports them after explicit approval of the returned snapshot. Follow every nextOffset when reviewing. Executable settings need separate allowScripts approval; removing a prior execution opt-in instead needs separate removeExecutableSettings approval. Read contents through platform operation team_skill, including path SKILL.md for frontmatter and listed script paths, before making that decision. Local edits are kept and reported.

Managed local MCP also starts a metadata check when a tool replies, at most once every 60 seconds and without delaying the reply; an idle session sends no checks. After detection it adds one prompt per changed snapshot to the next successful tool reply, asking whether to import; a later session does not ask about the same snapshot again, and platform_project_sync action check reviews it at any time. Detection never installs files. Enable/disable this mode with platform_project_sync or relvo team-skills auto-sync on|off|status. RELVO_PROJECT_AUTO_SYNC=0 disables checks for the process. There is no idle popup or OS background service. Known host names select that host's local files; otherwise the configured clients are shown in the review. Receipts are per client, though agents that share a skill folder still share its contents. Reload the host after import. Environment-only and remote URL connections do not offer local filesystem sync.

Costs and retries

Quotes are free. Searches count toward your team's monthly free calls and are charged after that allowance. Executions can spend your project balance; maximumChargeMicros optionally limits Relvo charges. External provider charges are separate.

Retain the run's idempotencyKey. After a lost reply, resend the same arguments and key or resume its runId. Read stored results instead of purchasing them again.

Local file uploads are disabled by default. Enable only the directories you need with RELVO_MCP_ALLOWED_UPLOAD_ROOTS, and upload only user-authorized files.

The server reads the npm registry once per start. When a newer release has been public for 72 hours, a one-time note in a tool result says how to update; nothing is installed. RELVO_AUTO_UPDATE=0 turns this off.

See Relvo docs for skills and configuration, or run npx --yes @relvo/mcp --help for server options.