Skip to content
MCP server

Helio

Open-source MCP proxy that enforces policies, budgets and approvals on agent tool calls

Install
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Remotely
Version
0.16.0
Listing updated
2 days ago

About Helio

Helio is an open-source MCP server for security. It runs as a hosted remote server, so there is nothing to install locally.

Rather than asking a model to follow rules in its prompt, Helio places the rules in the path of every tool call. It sits between an MCP client and your server, decides each call before forwarding it, and a denied call never reaches the upstream. Neither agent code nor the MCP server needs to change.

Policies are written in one helio.yaml that hot-reloads, with a dry-run mode to test a decision. The config starts with no active rules so you can watch what agents do before blocking anything. Rules can deny calls, cap cumulative spend across several payment tools, require a prerequisite call or fresh evidence, hold calls for approval through Slack, a webhook or the bundled dashboard, and block when a server changes a reviewed tool definition. Each call becomes an audit record, and a blocked agent gets a suggested next step.

Install with npx @gethelio/proxy init. An optional thin Python SDK adds evidence and dependency annotations.

Install

Run in a terminal

claude mcp add helio -- npx -y @gethelio/proxy

Add to claude_desktop_config.json

{
  "mcpServers": {
    "helio": {
      "command": "npx",
      "args": [
        "-y",
        "@gethelio/proxy"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "helio": {
      "command": "npx",
      "args": [
        "-y",
        "@gethelio/proxy"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "helio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gethelio/proxy"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "helio": {
      "command": "npx",
      "args": [
        "-y",
        "@gethelio/proxy"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "helio": {
      "command": "npx",
      "args": [
        "-y",
        "@gethelio/proxy"
      ]
    }
  }
}

What it does

Policy engine
YAML rules to deny, limit or require approval, with hot reload and dry-run.
Cross-tool budgets
One shared spend limit across tools such as Stripe and PayPal.
Prerequisites and evidence
Require an earlier successful call or fresh application evidence.
Approvals
Hold sensitive calls for a human via Slack, webhook or dashboard.
Tool-definition drift
Block or flag servers that change a reviewed tool.
Audit trail
Records who called what, which rule matched and the outcome.
Self-repair hints
Tells a blocked agent what to do next.

Good for

  • Deny refunds above a set amount
  • Cap daily spend across payment tools
  • Require an order lookup before a refund
  • Route risky production changes to a human
  • Keep an audit trail of agent actions

Pricing

Open source

Open source; hosted pricing not published

Prices change. Check helio.so before you buy.

Helio FAQ

Do I have to change my agent code?

No. Point your client at Helio and Helio at your server.

Where does state live?

The README says session identity, budgets and evidence are kept in the proxy, outside the agent's context.

How do I install it?

Run npx @gethelio/proxy init.

What if a server changes a tool?

Helio can block it, ask for approval or log it; the default is to block.

Is Helio free?

Yes. Helio is open source, so you can use and self-host it for free.

How do I add Helio to Claude Code?

Run this command in your terminal: claude mcp add helio -- npx -y @gethelio/proxy

What are the best alternatives to Helio?

The closest alternatives to Helio are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Helio

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools