Helious › AI agents
Helious · For AI agents

Bring Helious to your AI

Helious is a market data MCP server and API for AI assistants: 27 tools that let Claude, ChatGPT and any MCP client read US Treasury yields, economic releases scored the second they print and Treasury auction results, listed by name in the Claude and ChatGPT directories.

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

Claudein the directory

Helious is listed in the Claude connector directory. Open claude.ai/directory/helious, press Connect, sign in to Helious or create a free account on that screen, and press Allow. Adding it once covers the web app, the desktop app and Claude Code.

Or paste the address by hand:

  1. Open Customize › Connectors.
  2. Press the plus, choose Add custom connector.
  3. Paste the address below. Leave the authentication boxes empty.
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.

ChatGPTin the directory

Helious is listed in the ChatGPT plugin directory. Open the Helious listing, press Install plugin, sign in to Helious or create a free account on that screen, and press Allow. In a chat, ask a question that names Helious, or pick it from the plus menu next to the composer.

Or paste the address by hand, in developer mode:

  1. Settings › Security and login › switch on Developer mode.
  2. Go to chatgpt.com/plugins and press the plus.
  3. Name it Helious, paste the address under Connection, set authentication to No authentication.
  4. In any chat, pick Developer mode from the plus menu.
MCP server
https://api.helious.io/mcp

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

Grokpaste a URL
  1. Go to grok.com/connectors.
  2. Choose New Connector, then Custom.
  3. 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
  1. Account settings › Connectors › Custom connector › Remote.
  2. Paste the address below.
  3. 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.

Watch: Connect your AI to live market data with the Helious MCP server · 57s · open on YouTube

What it costs

PlanPriceNews and pricesHistoryCredits a month
Sample, no key$0News 1 hour behind. No market prices.1 day50, shared by your network address
Free account$0News and every price board 1 hour behind; a tool call with fresh: true answers live for 5 credits.None100
Starter$14.99/moLive news. Every price board 60 minutes behind; live for 5 credits a call.12 months1,500
Pro$39.99/moEverything live, plus the live streaming WebSocket on 2 connections a key. Every plan can run the stream delayed; Pro and Ultimate take it live.24 months3,000
Ultimate$99/moEverything live, the live streaming WebSocket on 5 connections a key, and commercial use.10 yearsNo cap

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. A typed question costs 10 credits from the same wallet your API calls use: Free has 100 a month, Starter 1,500, Pro 3,000, Ultimate no cap. Run low and there are two ways on, a pack or a plan. How the credits work, and how Ask Helious uses them.

Get your key

  1. Create a free account at helious.io.
  2. Open My account, then API keys, and press Create key.
  3. Paste the key into your AI. A free account gets no history, Starter turns the news live and opens 12 months of history, 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.