// // hermes integration

Market data for your
Hermes agent.

Connect TickerAPI to Hermes as an MCP server. Your agent gets market summaries, screeners, comparisons, and watchlists — accessible from CLI, Telegram, Discord, or any gateway you run.

try for free read the docs

// setup

Add to your config. Done.

Add TickerAPI to your Hermes config.yaml under mcp_servers. Remote or local, both work.

Point Hermes at TickerAPI's remote MCP server. No local install, no process to manage.

config.yaml

mcp_servers:
  tickerapi:
    url: "https://mcp.tickerapi.ai/mcp"
    headers:
      Authorization: "Bearer tapi_your_api_key"

Run /reload-mcp in the Hermes chat to pick up the new config without restarting.

Run the MCP server locally via npx. Hermes starts the process and connects automatically.

config.yaml

mcp_servers:
  tickerapi:
    command: "npx"
    args: ["tickerapi-mcp-server"]
    env:
      TICKERAPI_KEY: "tapi_your_api_key"

// in practice

How it looks in Hermes.

Once connected, Hermes calls TickerAPI tools automatically when you ask about markets. Same experience across CLI, Telegram, Discord, or any gateway.

You

Anything oversold in semiconductors right now?

Tool call: scan_oversold

{ "sector": "Semiconductors" }

Hermes

Three semiconductor stocks are oversold today. INTC is deep oversold for 8 consecutive days, which is historically rare (95th percentile). AMD just entered oversold territory with elevated volume. MRVL is mildly oversold but still in a downtrend with bearish MA alignment.

You

Compare INTC and AMD.

Tool call: compare_assets

{ "tickers": ["INTC", "AMD"] }

Hermes

INTC is in a strong downtrend, deep oversold, with a deep value valuation and analyst consensus at hold. Volume is extremely high — looks like a selling climax. AMD is in a downtrend too but only mildly oversold, fair value on fundamentals, with a buy consensus. The key divergence: INTC's condition is historically rare while AMD's is more common. INTC is the more extreme mean-reversion setup.

You

Add both to my watchlist. Check them every weekday morning and message me here if anything changes.

Tool call: add_to_watchlist

{ "tickers": ["INTC", "AMD"] }

Hermes

Done. INTC and AMD are on your watchlist. I've set up a daily check at 9:35 AM ET on weekdays. I'll message you here if either exits oversold, if volume spikes, or if the trend shifts.

// state changes

Track state changes effortlessly.

Most market data APIs return point-in-time snapshots. TickerAPI tracks state transitions — your agent sees what changed, not just what is.

json

{
  "ticker": "AAPL",
  "changes": [
    {
      "field": "rsi_zone",
      "from": "neutral",
      "to": "oversold"
    },
    {
      "field": "trend",
      "from": "uptrend",
      "to": "downtrend"
    }
  ]
}

// what your agent sees

What your agent sees.

Every tool returns categorical facts — not raw OHLCV data. Your agent can branch on "oversold" without needing to know what RSI > 70 means.

json

{
  "ticker": "NVDA",
  "trend": "strong_uptrend",
  "momentum": {
    "rsi_zone": "overbought",
    "macd_signal": "bullish"
  },
  "volatility": "high",
  "fundamentals": {
    "pe_zone": "above_historical_avg",
    "earnings_surprise": "positive"
  }
}