Helio
Open-source MCP proxy that enforces policies, budgets and approvals on agent tool calls
- 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/proxyAdd to claude_desktop_config.json
{
"mcpServers": {
"helio": {
"command": "npx",
"args": [
"-y",
"@gethelio/proxy"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"helio": {
"command": "npx",
"args": [
"-y",
"@gethelio/proxy"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools