# Helio

> Helio is an open-source MCP server for security. Open-source MCP proxy that enforces policies, budgets and approvals on agent tool calls. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI
- **Website:** https://www.helio.so
- **Repository:** https://github.com/gethelio/helio/tree/HEAD/packages/proxy
- **MCP Registry name:** so.helio/helio
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/helio
