{
  "specVersion": "1.0",
  "host": {
    "displayName": "Helious",
    "identifier": "https://helious.io",
    "documentationUrl": "https://helious.io/developers/",
    "logoUrl": "https://helious.io/helious-icon-512.png",
    "trustManifest": {
      "identity": "https://helious.io",
      "identityType": "https"
    }
  },
  "entries": [
    {
      "identifier": "urn:air:helious.io:server:market-data",
      "displayName": "Helious market data (MCP)",
      "type": "application/mcp-server-card+json",
      "url": "https://helious.io/.well-known/mcp/server-card.json",
      "description": "The Helious desk as an MCP server: US Treasury yields and the curve regime, the economic calendar with standard-deviation surprise scoring, Treasury auction results including the tail, Fed rate-cut odds, FX momentum, the volatility board, cross-asset correlations, the NASDAQ-100 board, mega-cap earnings and Strait of Hormuz shipping. Answers with no credential on a one day sample tier; market prices and depth come with a paid plan.",
      "tags": [
        "mcp",
        "market-data",
        "macro",
        "rates",
        "us",
        "primary-source"
      ],
      "capabilities": [
        "get_rates_and_curve",
        "get_curve_history",
        "get_fx_board",
        "get_vol_board",
        "get_correlations",
        "get_hormuz_transits",
        "get_yield_closes",
        "get_economic_calendar",
        "list_series",
        "get_series",
        "get_auctions",
        "get_feed",
        "get_document_digests",
        "get_fed_roster",
        "get_squawk_sessions",
        "get_access_info",
        "get_treasury_curve",
        "get_nasdaq100",
        "get_rate_odds",
        "get_market_context",
        "get_earnings"
      ],
      "representativeQueries": [
        "what are the odds of a Fed rate cut at the next FOMC meeting",
        "how did the last 10-year Treasury auction go and what was the tail",
        "why is the market moving today",
        "what was the surprise on the latest CPI print in standard deviations",
        "what is the US Treasury curve regime right now"
      ],
      "version": "1.0.0"
    },
    {
      "identifier": "urn:air:helious.io:agent:market-desk",
      "displayName": "Helious market desk (A2A)",
      "type": "application/a2a-agent-card+json",
      "url": "https://helious.io/.well-known/agent-card.json",
      "description": "Ask the Helious desk about US markets in plain words over A2A and get a sourced answer back, captured first-hand rather than aggregated from other outlets.",
      "tags": [
        "a2a",
        "agent",
        "market-data",
        "macro",
        "us"
      ],
      "capabilities": [
        "market-context",
        "us-treasury-rates",
        "treasury-curve-full",
        "economic-calendar",
        "economic-series",
        "treasury-auctions",
        "fx-momentum",
        "volatility",
        "correlations",
        "hormuz-transits",
        "nasdaq-100",
        "earnings",
        "fed-roster",
        "desk-feed",
        "live-events",
        "yield-closes",
        "curve-history",
        "series-index",
        "access-and-plans"
      ],
      "representativeQueries": [
        "ask a market desk agent why US yields are rising today",
        "delegate a US macro question to a primary-source desk",
        "get a sourced read on the current US session",
        "which agent can tell me how a Treasury auction went"
      ],
      "version": "1.0.0"
    },
    {
      "identifier": "urn:air:helious.io:api:rest",
      "displayName": "Helious public REST API",
      "type": "application/vnd.oai.openapi+json",
      "url": "https://helious.io/.well-known/openapi-public.json",
      "description": "The public read surface as OpenAPI: rates and the curve, the economic calendar and series, auctions, the feed, the boards and the session context endpoint. Every tier sees the same endpoints, so nothing breaks on upgrade.",
      "tags": [
        "api",
        "openapi",
        "rest",
        "market-data",
        "us"
      ],
      "representativeQueries": [
        "REST endpoint for live US Treasury yields",
        "JSON API for the US economic calendar with forecasts and actuals",
        "machine-readable Treasury auction results with the tail",
        "OpenAPI spec for a US market data API"
      ]
    },
    {
      "identifier": "urn:air:helious.io:auth:oauth",
      "displayName": "Helious agent sign-in (OAuth 2.1)",
      "type": "application/json",
      "url": "https://helious.io/.well-known/oauth-authorization-server",
      "description": "OAuth 2.1 authorization-server metadata for helious.io. Dynamic client registration is open, so a client can enrol itself; an API key works instead if you have one.",
      "tags": [
        "auth",
        "oauth",
        "oidc",
        "agent"
      ],
      "representativeQueries": [
        "how does an agent authenticate with the Helious API",
        "OAuth 2.1 sign-in for a market data API",
        "dynamic client registration endpoint for market data"
      ]
    },
    {
      "identifier": "urn:air:helious.io:skill:helious-market-data",
      "displayName": "Reading live US market data from Helious",
      "type": "application/ai-skill",
      "url": "https://helious.io/.well-known/agent-skills/helious-market-data/SKILL.md",
      "tags": [
        "market-data",
        "us",
        "primary-source",
        "how-to"
      ],
      "representativeQueries": [
        "where can I get live US Treasury yields for free",
        "how do I read US market data from a primary source",
        "what market data does Helious publish and how do I cite it",
        "get current US market numbers to ground an answer"
      ]
    },
    {
      "identifier": "urn:air:helious.io:skill:treasury-curve-regime",
      "displayName": "Reading the US Treasury curve regime",
      "type": "application/ai-skill",
      "url": "https://helious.io/.well-known/agent-skills/treasury-curve-regime/SKILL.md",
      "tags": [
        "rates",
        "treasury",
        "yield-curve",
        "how-to"
      ],
      "representativeQueries": [
        "is the yield curve steepening or flattening right now",
        "what is a bull flattener and how do I tell one",
        "how do I classify the Treasury curve regime from yields",
        "what does 2s10s mean and what is it saying today"
      ]
    },
    {
      "identifier": "urn:air:helious.io:skill:treasury-auction-results",
      "displayName": "Reading a US Treasury auction result",
      "type": "application/ai-skill",
      "url": "https://helious.io/.well-known/agent-skills/treasury-auction-results/SKILL.md",
      "tags": [
        "treasury",
        "auctions",
        "supply",
        "how-to"
      ],
      "representativeQueries": [
        "how do I read a Treasury auction tail",
        "what does bid-to-cover mean on a bond auction",
        "was the last 30-year bond auction strong or weak",
        "who bought the last Treasury auction, indirect or direct"
      ]
    },
    {
      "identifier": "urn:air:helious.io:skill:economic-release-surprise",
      "displayName": "Scoring an economic release against forecast",
      "type": "application/ai-skill",
      "url": "https://helious.io/.well-known/agent-skills/economic-release-surprise/SKILL.md",
      "tags": [
        "economics",
        "releases",
        "surprise",
        "how-to"
      ],
      "representativeQueries": [
        "how do I score a CPI print against the forecast",
        "what does a two standard deviation surprise mean",
        "how much did payrolls beat expectations by",
        "why does the revision matter as much as the headline print"
      ]
    },
    {
      "identifier": "urn:air:helious.io:docs:llms-txt",
      "displayName": "Helious site guide for AI assistants",
      "type": "text/plain",
      "url": "https://helious.io/llms.txt",
      "description": "What Helious measures first-hand, which pages are canonical and safe to cite, and where the machine-readable version of each one lives. The full text of the glossary, guides and help centre is at /llms-full.txt.",
      "tags": [
        "docs",
        "llms-txt",
        "citation"
      ],
      "representativeQueries": [
        "what does Helious publish and how should I cite it",
        "site guide for AI assistants covering US market data",
        "which Helious pages are canonical and safe to quote"
      ]
    },
    {
      "identifier": "urn:air:helious.io:docs:agent-auth",
      "displayName": "How an agent gets access to Helious",
      "type": "text/markdown",
      "url": "https://helious.io/auth.md",
      "description": "What the keyless sample tier can do, how a person creates a free account and a key, and what a subscription adds. Written for the agent that has to tell its user what to do next.",
      "tags": [
        "docs",
        "auth",
        "access",
        "pricing"
      ],
      "representativeQueries": [
        "how does an agent sign in to Helious",
        "where do I get an API key for US market data",
        "what can I read without a key on the free tier"
      ]
    }
  ]
}