Aster Agent Gateway MCP server

aster-agent-gateway

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

An MCP (Model Context Protocol) server that gives AI agents read-only, keyless access to Aster DEX public data - ~580 futures symbols (including 24/7 TradFi perps: metals, equity indices, energy, treasuries), ~68 spot pairs, funding, order books, klines, vault deposit flows and tapi account views. No API keys, no auth, no signing, no writes: every tool reads public endpoints only (fapi.asterdex.com/fapi/v3, sapi.asterdex.com/api/v3, tapi.asterdex.com/info, api.mainnet-beta.solana.com, plus optional EVM RPCs), cached and rate-limited so an enthusiastic agent cannot hammer the upstream.

Use cases

• Screen 731 funding rates in one call — ranked by annualized rate with funding regime and mark/index spread; the 793% outliers are visible instantly
• Trade TradFi 24/7 — metals, equity indices, energy, treasuries perps next to crypto, one consistent API
• Follow the vault money — deposit flows per vault: who is parking capital where
• Spot index dislocations — mark vs index divergence ranking across the whole board
• Morning scan — market overview + funding overview + OI snapshot, three cheap calls

Full walkthroughs: examples/use-cases.md.

Quickstart

Claude Code:

claude mcp add aster -- uvx aster-agent-gateway

stdio (default, for local agents):

uvx aster-agent-gateway

or from a checkout:

git clone https://github.com/alekskram/aster-agent-gateway
cd aster-agent-gateway
uv sync
uv run aster-agent-gateway

Claude Desktop / Cursor config:

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

Hosted form — streamable HTTP on port 8904:

uvx aster-agent-gateway --http             # 127.0.0.1:8904
curl http://127.0.0.1:8904/health   # -> {"ok": true, "service": "aster-agent-gateway", ...}

Codex (~/.codex/config.toml)

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

ZCode — register the server (copy-paste)

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

# 2) register it (merges into ~/.zcode/cli/config.json)
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", {})["aster"] = {
    "type": "http", "url": "http://127.0.0.1:8904/mcp"}
json.dump(cfg, open(p, "w"), indent=2)
print("aster-agent-gateway registered:", p)
PY

Tools

All 13 tools are read-only (annotated readOnlyHint: true, destructiveHint: false).

Shortened. The full README is on GitHub.