@opengamma/mcp-server

Thin MCP stdio adapter for OpenGamma member market-context APIs.

This package does not contain the private OpenGamma application repository. It runs locally as a Model Context Protocol stdio server and calls authenticated OpenGamma HTTPS APIs using a member token.

Requirements

• Node.js 18 or newer.
• Active paid OpenGamma membership.
• An ogmcp_ member token generated from /account/mcp.

Claude Code Config

{
  "mcpServers": {
    "opengamma": {
      "command": "npx",
      "args": ["-y", "@opengamma/mcp-server"],
      "env": {
        "OPENGAMMA_BASE_URL": "https://opengammaai.com",
        "OPENGAMMA_API_TOKEN": "<YOUR_MEMBER_TOKEN>"
      }
    }
  }
}

The same command/env pattern works for MCP clients that support local stdio servers.

What This Adapter Does

• Registers 21 approved read-only OpenGamma MCP tools, including get_asset_coverage for the static launch matrix.
• Sends Authorization: Bearer <YOUR_MEMBER_TOKEN> to OpenGamma HTTPS APIs.
• Returns market context such as health, spot, regime, GEX, Greeks, IV, charm, vanna, terrain, and exact-DTE ladder data.
• Normalizes futures aliases (ES/MES -> SPX, NQ/MNQ -> NDX, RTY/M2K -> RUT) before calling backend APIs.
• Exposes ETF and launch single-stock rails only where the static coverage matrix marks the tool as available or partial.

What This Adapter Does Not Do

• Does not include private app source.
• Does not write to OpenGamma databases.
• Does not expose privileged server operations or trading-execution tools.
• Does not execute trades or talk to brokers.
• Does not accept legacy cron credentials as member tokens.

Quick Test

After adding the config, restart your MCP client and ask:

Use OpenGamma MCP health_check and tell me whether the site is reachable.

Then test a paid route:

Use OpenGamma MCP to get the current RUT spot price and report the staleness field.

If you receive a 401 or 403, generate a fresh token at /account/mcp and confirm your paid membership is active.