Arcus Agent Gateway MCP server

arcus-agent-gateway

<!-- mcp-name: io.github.alekskram/arcus-agent-gateway -->

An MCP (Model Context Protocol) server that gives AI agents read-only, keyless access to market data for the 194 tokenized US equities on Robinhood Chain (Arcus) — quotes, corporate actions, trading capabilities, multipliers and a 13-sector map. No API keys, no auth, no writes: every tool is a GET against the public api.robinhood.com/rhj REST surface, cached and rate-limited so an enthusiastic agent can't hammer the upstream.

Use cases

• "Who actually holds AAPL?" — top holders with on-chain share %, contract vs EOA, concentration risk (holder_snapshot scenario)
• Watch any wallet — full portfolio across all 194 tokenized equities, valued at cached quotes (wallet_holdings)
• Catch whale moves — live ERC-20 Transfer feed with a minvalue filter for large-print alerts (transferhistory)
• Split-safe prices — raw vs multiplier-adjusted quotes side by side, pending-split warnings with effective time (quote, token_detail)
• Morning scan — market-wide health, halted tokens and 13-sector averages in two cheap calls (marketstatus, sectorview(warm=True))

Full walkthroughs with real outputs: examples/use-cases.md.

Quickstart

Claude Code:

claude mcp add arcus -- uvx arcus-agent-gateway

Run over stdio (the default, for local agents):

uvx arcus-agent-gateway

Standard config for Claude Desktop / Cursor (claudedesktopconfig.json / .cursor/mcp.json):

{
  "mcpServers": {
    "arcus": {
      "command": "uvx",
      "args": ["arcus-agent-gateway"]
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.arcus]
command = "uvx"
args = ["arcus-agent-gateway"]

ZCode — register the server and copy the agent skill (copy-paste)

# 1) start the gateway (keep it running)
uvx arcus-agent-gateway --http --port 8902 &

# 2) register it (merges into ~/.zcode/cli/config.json; workspace .zcode/config.json works too)
python3 - <<'PY'
import json, os
p = os.path.expanduser("~/.zcode/cli/config.json")
os.makedirs(os.path.dirname(p), exist_ok=True)
cfg = json.load(open(p)) if os.path.exists(p) else {}
cfg.setdefault("mcp", {}).setdefault("servers", {})["arcus"] = {
    "type": "http", "url": "http://127.0.0.1:8902/mcp"}
json.dump(cfg, open(p, "w"), indent=2)
print("arcus MCP server registered:", p)
PY

# 3) copy the agent skill (tool guide + watchlist cron recipe)
git clone -q --depth 1 https://github.com/alekskram/arcus-agent-gateway /tmp/aag
cp -r /tmp/aag/.agents/skills/arcus-gateway ~/.zcode/skills/ && rm -rf /tmp/aag
echo "ZCode setup done — restart your session and call any arcus tool"

Hosted form — streamable HTTP on port 8902:

uvx arcus-agent-gateway --http               # 127.0.0.1:8902
curl http://127.0.0.1:8902/health            # -> {"ok": true, "service": "arcus-agent-gateway"}

Tools

All 13 tools are read-only (annotated readOnlyHint: true). Names and parameters are exactly as registered by arcus_mcp/server.py.

Shortened. The full README is on GitHub.