Helious › AI agents

Helious · For AI agents

Bring Helious to your AI

Claude, ChatGPT and other AI assistants can read Helious directly: live Treasury yields, every economic release the moment it prints, auction results, the boards and the news feed. Each number comes with its own history, so your AI can tell you whether a print matters. Setup takes about two minutes and starts free.

Connect in two minutes

You paste one address, and it is the same in every app. You do not need a key to start. The steps for each assistant are below.

MCP server

https://api.helious.io/mcp

Chat apps

Claudepaste a URL

Open Customize › Connectors.
Press the plus, choose Add custom connector.
Paste the address below. Leave the authentication boxes empty.

Adding it once covers the web app and the desktop app.

MCP server

https://api.helious.io/mcp

On a Free plan you get one custom connector. On Team or Enterprise an owner adds it first, then members press Connect.

ChatGPTpaste a URL, developer mode

Settings › Security and login › switch on Developer mode.
Go to chatgpt.com/plugins and press the plus.
Name it Helious, paste the address under Connection, set authentication to No authentication.
In any chat, pick Developer mode from the plus menu.

MCP server

https://api.helious.io/mcp

Web only, not the mobile apps. On a Business or Enterprise workspace an admin has to allow it first.

Grokpaste a URL

Go to grok.com/connectors.
Choose New Connector, then Custom.
Paste the address below.

MCP server

https://api.helious.io/mcp

On a Business or Enterprise team an admin provisions it in the xAI console first.

Perplexitypaste a URL

Account settings › Connectors › Custom connector › Remote.
Paste the address below.
Transport Streamable HTTP, authentication None.

MCP server

https://api.helious.io/mcp

Connectors need Pro, Max or Enterprise. The free plan cannot add one.

Command line

Claude Codeone command

Terminal

claude mcp add --transport http helious https://api.helious.io/mcp

Add --scope user to have it in every project.

Codex CLIone config file

Add this to ~/.codex/config.toml. The ChatGPT desktop app and the Codex IDE extension read the same file, so one edit covers all three.

~/.codex/config.toml

[mcp_servers.helious]
url = "https://api.helious.io/mcp"

Gemini CLIone command

Terminal

gemini mcp add --transport http --scope user helious https://api.helious.io/mcp

Without --scope user it lands in the current project only.

Grok CLIone command

Terminal

grok mcp add --transport http helious https://api.helious.io/mcp

Editors

Cursorone config file

Add to Cursor in one click

Or put this in .cursor/mcp.json, in your project or your home folder, and restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "helious": {
      "url": "https://api.helious.io/mcp"
    }
  }
}

VS Code with Copilotone config file

Put this in .vscode/mcp.json, or run MCP: Add Server from the command palette.

.vscode/mcp.json

{
  "servers": {
    "helious": {
      "type": "http",
      "url": "https://api.helious.io/mcp"
    }
  }
}

The key is servers, not mcpServers, and type is required. On a Copilot Business or Enterprise seat an org admin has to turn MCP servers on first.

Windsurfone config file

Put this in ~/.codeium/windsurf/mcp_config.json, then press refresh in Cascade. The VS Code and JetBrains plugins read ~/.codeium/mcp_config.json instead.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "helious": {
      "serverUrl": "https://api.helious.io/mcp"
    }
  }
}

Zedone config file

Settings › AI › MCP Servers › Add Remote Server, or edit your settings directly.

Zed settings.json

{
  "context_servers": {
    "helious": {
      "url": "https://api.helious.io/mcp"
    }
  }
}

Clineone config file

Open the MCP Servers panel, choose Remote Servers, and set the transport to Streamable HTTP. In the config file it looks like this.

Cline mcp.json

{
  "mcpServers": {
    "helious": {
      "type": "streamableHttp",
      "url": "https://api.helious.io/mcp"
    }
  }
}

The type line matters here. Leave it out and Cline falls back to the older SSE transport, which this server does not answer.

JetBrains AI Assistantone config file

Settings › Tools › AI Assistant › Model Context Protocol (MCP) › Add. Junie reads ~/.junie/mcp/mcp.json with the same contents.

mcp.json

{
  "mcpServers": {
    "helious": {
      "url": "https://api.helious.io/mcp"
    }
  }
}

Not listed here, or you would rather make plain web requests? The same data is an ordinary API. Start at helious.io/developers.

What to ask

Once connected, ask in plain words:

What is the Treasury curve doing today?
Was this morning's 10-Year auction strong or weak?
How hot was CPI against its own history?
What prints this week, and what is forecast?

Every answer opens with a plain sentence, names Helious, and links to the page it came from, so you can check the number yourself. Each number also carries something to judge it against: a percentile in its own history, the average of the last twelve auctions, or a dated note like highest close since 2007.

What it costs

Plan	Price	News and prices	History	Ask Helious
Sample, no key	$0	News 1 hour behind. No market prices.	1 day	No
Free account	$0	News 1 hour behind. No market prices.	7 days	No
Starter	$14.99/mo	Live news. Treasury yields and the curve 60 minutes behind.	12 months	No
Pro	$39.99/mo	Everything live.	24 months	30 credits a month
Ultimate	$99/mo	Everything live, plus the live streaming WebSocket and commercial use. Every plan can run the stream delayed; Ultimate takes it live.	10 years	200 credits a month

Every plan uses the same addresses and gets the same answer shapes, so the setup inside your AI never changes when you move up. Upgrading is just adding a key.

The last column is a different thing from this page. Everything above is your assistant reading Helious. Ask Helious is ours, inside the terminal: you ask in plain English and it answers from the live market data, showing the numbers it used. The standing reads are free on every plan. A typed question costs one credit, and Pro and Ultimate include a monthly allowance. How the credits work.

Get your key

Create a free account at helious.io.
Open My account, then API keys, and press Create key.
Paste the key into your AI. A free account gets 7 days of history, Starter turns the news live, and Pro makes every price live.

Keys belong to people

A person creates the account and the key, never the AI itself. Your agent can read its own setup guide at helious.io/auth.md.

For developers

If you are writing code rather than chatting, start with these four.

Docs

Interactive API reference

Every address explained in plain words, with try-it-out in the browser.

Spec

OpenAPI file

The machine-readable contract, for code generators and agents.

Sign-in guide

auth.md

The setup steps written for an agent to read by itself.

Site map for AI

llms.txt

A plain-text map of everything Helious publishes.