---
title: "Helious MCP Server: Connect Live Market Data"
description: Connect an MCP client for live US Treasury yields, the curve regime, auction results, scored releases, Fed rate-cut odds and FX. Sample tier needs no key.
source: Helious
canonical: "https://helious.io/mcp"
---

# Helious MCP server

    Helious is a remote MCP server for US market data: 27 tools
      that give Claude, ChatGPT, Cursor and any MCP client Treasury yields, economic releases scored the second
      they print and Treasury auction results with a verdict and, on notes and bonds, the tail.


      This URL is a Model Context Protocol endpoint. Point an MCP client at it and Helious
      arrives as tools: Treasury yields and the curve regime, the economic calendar with
      surprise scoring in standard deviations, auction results with a verdict and the tail on notes and bonds, Fed
      rate-cut odds, FX momentum, the volatility board and cross-asset correlations.



      You do not need a key to start. The sample tier answers without one.




## Connect




      Server URL
      https://helious.io/mcp

      Transport
      streamable HTTP

      Auth
      OAuth 2.1, or none on the sample tier

      Server card
      https://helious.io/.well-known/mcp/server-card.json



      In Claude and ChatGPT there is nothing to paste: Helious is listed in the
      [Claude connector directory](https://claude.ai/directory/helious) and the
      [ChatGPT plugin directory](https://chatgpt.com/plugins/plugin_asdk_app_6adfd6d8e6288191b37c46c229f664f4),
      both under TradeIQ Ltd. Search for Helious, press Connect or Install plugin, and sign in.
      In any other client with a connector setting, add a custom connector and paste
      the server URL above. In an editor that reads a JSON config, add it as a
      streamable-http server with that same URL.
      The full reference at
      [https://helious.io/developers/](https://helious.io/developers/) covers how to mint a
      key and what each plan opens up. Agents can read the short setup guide at
      [https://helious.io/auth.md](https://helious.io/auth.md) themselves.





## The 27 tools






- `get_rates_and_curve`
        **Treasury yields and the curve regime**
        US Treasury yields, the 2s10s and other spreads, and the curve regime (bull or bear, steepener or flattener) with the time it flipped. Yields are market prices: current or an hour behind according to the connected account, and a note instead of numbers without one.


- `get_curve_history`
        **Curve regime flips**
        Past curve regime changes: every flip with its time, what it flipped from, and how the session closed.


- `get_fx_board`
        **FX momentum board**
        FX momentum scorecard: seven major currencies scored against the basket. Newest reading plus past boards. Market data: numbers follow the connected account.


- `get_vol_board`
        **Volatility board**
        Implied volatility board: VIX and the other vol gauges with their one-year percentile. Newest reading plus past boards. Market data: numbers follow the connected account.


- `get_inflation`
        **Inflation**
        Every US inflation measure on one axis: headline and core CPI and PCE, supercore, the trimmed means, the median, the sticky and flexible splits, the CPI components, and what markets expect next. Each one comes back with its year-over-year reading plus 1, 3 and 6-month annualised, so you never have to annualise anything yourself. Also says which parts of the basket are driving the headline rate. `measures` filters by key, `history` adds the monthly series. Published statistics, so it answers on every tier.


- `get_jobs`
        **Jobs**
        Every US employment measure on one axis: total nonfarm payrolls split into private and government, the ten private sectors, federal, state and local government, ADP's own private count by sector, initial and continuing jobless claims, and JOLTS openings, hires, quits and layoffs including openings by sector. Each comes back with its monthly change plus 3, 6 and 12-month windows, in THOUSANDS of jobs. Also says which sectors drove the headline, and those parts sum to it exactly. Percentages such as the unemployment and quits rates ride in `standing`. `measures` filters by key, `history` adds the monthly series. Published statistics, so it answers on every tier.


- `get_rate_path`
        **Rate path**
        What the market is paying for US interest rates up to four years out. Two strips, kept apart because they are DIFFERENT RATES: `sr3` is sixteen quarterly 3-month SOFR futures grouped into the whites, reds, greens and blues a rates desk quotes, and `ff` is forty-eight monthly 30-day fed funds contracts. Every contract carries its implied rate now and the rate the SAME contract carried six and twelve months ago, so the gap is the market changing its mind rather than a different instrument. Rates are percent. These are traded prices and not forecasts. Do not compare the two lanes contract by contract: SOFR is secured and the fed funds effective rate is not, and an SR3 month spans the quarter between two IMM dates while a fed funds month is a calendar month.


- `get_treasury_issuance`
        **Treasury borrowing and cash**
        Monthly US Treasury borrowing: marketable debt sold, gross and net, split into bills, notes (TIPS and floating-rate notes included) and bonds, the cash balance the Treasury holds at the Fed, a quarterly rollup, and the refunding schedule ahead. Figures are billions of dollars. `measures` filters by key, `history` adds the monthly series. Published statistics, so it answers on every tier; the history depth follows your plan.


- `get_correlations`
        **Cross-asset correlations**
        Cross-asset correlation matrix (stocks, bonds, dollar, gold, oil) over 30 to 120 day windows. Newest reading plus past boards. Market data: numbers follow the connected account.


- `get_hormuz_transits`
        **Strait of Hormuz transits**
        Ships through the Strait of Hormuz per day, split tanker and cargo, measured by Helious from live ship tracking.


- `get_yield_closes`
        **Official 17:00 Treasury closes**
        Official 17:00 New York Treasury yield closes per session, as Helious recorded them. Before that ledger began, the official daily Treasury yields back to 2000 (record 'official') when since or before asks for them. Availability follows the connected account.


- `get_economic_calendar`
        **Economic calendar**
        Economic releases with forecasts, prior values and the actual once it prints, plus Fed speakers and auction times. Defaults to yesterday through the next 7 days; widen days_back and days_ahead to see more, or filter to one country like US, EU, GB or JP. Pass event to read one release's consensus record instead: for each past print the consensus that stood, the first actual, the previous and the revised prior, with its surprise, newest first. Across the US, the euro area, the UK, Japan and Germany; how far back a call reads is the plan's history window (12 months on Starter, 24 on Pro, 10 years on Ultimate).


- `list_series`
        **Economic series Helious tracks**
        Every US economic data series Helious tracks (CPI, payrolls, GDP and so on) with its slug for get_series. Draws no credit.


- `get_series`
        **One economic series in depth**
        One economic data series: the latest print, the forecast, the surprise in standard deviations, and the history. consensus_history carries the consensus record Helious holds for the release: the consensus, first actual, previous and revised prior at each print, inside the plan's history window.


- `get_auctions`
        **Treasury auction results and tails**
        US Treasury auction results, measured by Helious at the close: the high yield, the tail against the when-issued yield, bid-to-cover against the tenor's twelve-auction average, who bought (indirect, direct, dealer), and the desk's strong, in line or weak verdict. Pass tenor to ask about one part of the curve, like 10-year-note or 30-year-bond, which is what you want for 'how did the last 10-year auction go'. The tail is the number that answers whether an auction was good or bad.


- `get_feed`
        **The Helious feed**
        The Helious feed, newest first: the posts Helious publishes (kind post: releases with their surprise, auction results, board updates, the daily brief and live squawk lines) and the news wire (kind headline: breaking news, geopolitics, official statements, central bank speakers, bank and business notes). Every item has a stable id, and items carry two score channels on a -10 to +10 scale: score and direction for bonds, equity_score and equity_direction for stocks. The same story can be bullish for bonds and bearish for stocks, so read the channel you trade. topic is what the item is about, the code the terminal prints on the row (equities, bonds, cb, geo, data, chatter); category is only the lane it came in on, so a stock story off the news wire has category news and topic equities. Most items carry helious_read, Helious's plain-English line on why it matters. A headline also carries carried_at (when it crossed the Helious wire; created_at is the story's own timestamp) and a URL-free thread_id that stays the same when a story is retitled. No headline carries a link or an image. Depth follows the connected account for the permanent posts: releases, auctions, desk posts, the brief, the minutes. Headlines are kept 7 days whatever the plan (official statements and Fed speakers 400 days), as are squawk lines and the board lanes. Optional q filters by word; categories narrows to chosen lanes; kind narrows to headline or post; topics narrows to what items are about; since moves the window's start later. The filters search the whole window and matched counts every match. Where the account receives news an hour behind, the hold runs from created_at on a post and from the later of created_at and carried_at on a headline.


- `get_document_digests`
        **FOMC minutes and speech digests**
        The desk's read of FULL central bank documents, not headlines: FOMC minutes and Fed/ECB speeches read end to end. Each digest carries a summary, what is genuinely new versus what the market already knew, key findings with their market consequence, a hawkish/dovish committee lean, and quotes verified word for word against the source document. Minutes carry no bond or equity direction on purpose: they describe a meeting about three weeks earlier, so the desk states the lean and declines the market call. Delayed 60 minutes where the account receives news an hour behind.


- `get_fed_roster`
        **The FOMC roster**
        Who is on the FOMC: governors and presidents, who votes this year, their lean, and their upcoming speeches.


- `get_squawk_sessions`
        **Transcribed live events**
        Live events Helious transcribed in the last week (Fed pressers, briefings), one entry per event.


- `get_access_info`
        **Your plan and how to get more**
        What the connected account can read, what a call costs and what is left this month, and the steps to relay to your user when a result needs more than the account allows. Draws no credit.


- `get_build_plan`
        **Plan an integration**
        What to build with Helious and how: for a stated goal, the tools to call in order, what each returns, what it costs in credits at your cadence, and which plan covers it. Use this when someone is building an integration, a bot, a dashboard or a strategy, before the first data call.


- `get_treasury_curve`
        **The whole Treasury curve**
        The whole US Treasury curve in one call, 3M bill to 30Y bond with daily closes. Points are market prices: current or an hour behind according to the connected account, and a note instead of numbers without one.


- `get_nasdaq100`
        **NASDAQ-100 board**
        The NASDAQ-100 ranked best to worst on the session: price, change and sector for every stock. Pass symbol to ask about ONE company instead, like AAPL or NVDA, and you get its price, its move on the session and where it ranks on the board today. Equities are market data: numbers follow the connected account.


- `get_market_imbalance`
        **Market imbalance into the open and close**
        Net dollars to buy or sell into the NYSE opening and closing auctions, calculated by Helious from every NYSE listing's own imbalance print: the whole NYSE market and the S&P 500 names the feed carries, each with its paired volume, the ten largest single names to buy and to sell, and the Helious read of what the lean means for the print. Reads land at 9:28 and 9:29 ET for the open and 3:50, 3:55 and 3:58 PM ET for the close; every read is stored. THIS IS THE TOOL for 'what is the imbalance into the close', 'market on close', 'MOC' or 'how much is there to buy at the bell'. Pass symbol for ONE NYSE-listed name's own prints at every read of a session (side, shares, price, dollars, paired shares); a Nasdaq or NYSE Arca listing answers on_feed false. Market data: numbers follow the connected account.


- `get_rate_odds`
        **Fed rate cut and hike odds**
        The odds of a Federal Reserve rate cut or hike at each remaining FOMC meeting, priced from fed funds futures. THIS IS THE TOOL for 'what are the odds of a cut in September', 'is the Fed cutting', 'what is priced in for the next meeting' or 'how many cuts this year'. Gives the probability per meeting, the implied effective rate after each one, and the total move priced across the whole path. Computed by Helious from settlement prices against the effective fed funds rate, not the target midpoint.


- `get_market_context`
        **Why the market is moving**
        START HERE for any 'why is the market doing this' question. One call gives the whole cross-asset board (equities, the Treasury curve, FX, volatility, commodities), every scored economic release behind it, and the Helious desk's read on what is actually driving the session: whether it is event-driven, event-adjacent, flow-driven or quiet, the evidence that read rests on, and the regime yields and stocks have actually been trading in. Use this before the individual board tools: it saves five calls, and it characterises the session rather than leaving you to guess a cause. Market data: numbers follow the connected account.


- `get_earnings`
        **Mega-cap earnings dates and EPS**
        US mega-cap earnings: when a company reports, whether that date is confirmed or still an estimate, whether it prints before the open or after the close, the consensus EPS, and once it lands the reported EPS with the beat or miss. Pass symbol for one name, like AAPL. This is the tool for any question about a company's earnings date or EPS.





      If you are sending JSON-RPC rather than reading, POST to this same URL. A GET that asks for
      text/event-stream comes back 405 with
      allow: POST, because the server is
      stateless and holds no session to stream over.


    [Open the terminal →](https://helious.io/)
