Let your AI assistant read GEX key levels: connect HermesGEX in 3 minutes (free)

What this is

Many AI assistants now support MCP (Model Context Protocol): you give the assistant a URL and it gains a set of tools it can call mid-conversation to get fresh data.

The HermesGEX MCP connection gives the assistant two tools:

Tickers: SPX, SPY, QQQ, plus ES and NQ (already in futures prices) with a key. All data is delayed 30 minutes.

Why connect an AI instead of reading the page

The page shows the same numbers. Connecting an AI lets you ask questions:

• "How far is NQ from its put wall right now?"
• "How many times did ES cross zero gamma yesterday?"
• "Did SPX flip regime this morning?"

The assistant fetches the data, works out the distances, checks the history and explains the result. If you are new to GEX, that is an easier way in than staring at numbers.

How to connect

Step 1: get your connection URL

Sign up for free, log in, open Settings → Data API and copy the AI assistant connection URL from the "Free data API key" card. It looks like:

https://hermesgex.com/api/mcp?key=hgx_pub_...

The URL contains your key — keep it private like a password.

You can also use https://hermesgex.com/api/mcp without signing up, but without ES / NQ. Also, web assistants such as Claude and ChatGPT fetch data from their own servers, so without a key many people share one call allowance and you may see "too many requests". Use the URL with your key.

Step 2: add it to the assistant you use

You choose the AI and the model; HermesGEX only supplies the data. Here is how to add it to common assistants. Menus change from time to time — if a name doesn't match, look for "Connectors", "Plugins / Apps" or "MCP".

Claude (web, desktop, mobile)

1. Open Customize → Connectors.
2. Click Add, then Add custom connector. If you are asked for a type first, choose Custom → Web.
3. Name it HermesGEX, paste the connection URL and click Continue.
4. Under authentication choose No sign in, then click Add.
5. In a chat, open + → Connectors at the lower left and make sure HermesGEX is on.

The free Claude plan allows one custom connector. On Team / Enterprise plans an owner adds it first under Organization settings → Connectors.

ChatGPT (web)

1. Open Plugins (shown as Settings → Apps on some accounts).
2. Click +, then Add custom MCP server.
3. Name it HermesGEX and paste the connection URL as the Server URL.
4. Choose No authentication, accept the risk notice, click Create, then install it.
5. In a chat, type @, pick HermesGEX and ask your question.

Custom connections can only be added on the web, and availability depends on your ChatGPT plan. If you don't see the option, your account doesn't support it yet — use one of the other options below.

Claude Code (command line)

Run one line in a terminal, with your own URL:

claude mcp add --transport http hermesgex "https://hermesgex.com/api/mcp?key=YOUR_KEY"

Cursor

Edit ~/.cursor/mcp.json (applies to every project) and add:

{
  "mcpServers": {
    "hermesgex": {
      "url": "https://hermesgex.com/api/mcp?key=YOUR_KEY"
    }
  }
}

Restart Cursor. Seeing hermesgex with two tools in the MCP list in settings means it is connected.

VS Code (Copilot)

Create .vscode/mcp.json in your project. Note that VS Code uses servers, not mcpServers:

{
  "servers": {
    "hermesgex": {
      "type": "http",
      "url": "https://hermesgex.com/api/mcp?key=YOUR_KEY"
    }
  }
}

Other MCP assistants

Any assistant that supports remote MCP (Streamable HTTP) works the same way: add a remote / URL connection with your keyed URL and choose no authentication.

If the config file lives in a project, don't commit the file with your key to a public repository.

Questions to try

• "Use HermesGEX to get ES's key levels. Where is price between the call wall and put wall?"
• "Is NQ in long or short gamma right now? What does that usually mean for volatility?"
• "Get SPX's level history for the previous trading day. Did zero gamma drift up or down?"
• "Is it pre-market right now? If so, which values aren't available yet?"

Three things to watch in the answers

A few fields exist so the assistant doesn't make things up:

• stale: true during market hours if no new data arrived for too long. The assistant should say the data is outdated instead of analysing old numbers.
• basis: oi before the open — walls come from open interest, and zero gamma, HVL and regime are empty. It becomes vol after the open.
• missing_minutes (history): how many minutes of that day have no stored data. If it isn't 0, take history-based conclusions with a grain of salt.

If an answer contradicts these fields — for example it gives advice while the data is stale — point it out and ask the assistant to check again.

Limits

• Data is delayed 30 minutes; it is not for chasing levels in real time.
• Levels are model-derived, and the AI's reading can be wrong. Use this for prep, review and learning GEX — not as a trade signal.
• History covers the last 5 trading days only. For longer history, use replay in the HuntingFlow terminal.
• 60 tool calls per minute with a key (20 without), far more than a normal conversation needs.

For every field, or to call the API from your own scripts, see Free key-levels API. For second-by-second levels, use the HuntingFlow terminal.

For information and education only. Not investment advice.