Aster Agent Gateway

io.github.alekskramPublished by GitHub account alekskramv0.1.3Updated Oct 24, 2026

Read-only MCP gateway to Aster DEX: 24/7 gold, oil and equity perps, funding with real intervals.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Read-only, keyless MCP gateway to Aster DEX market data: futures and spot pairs, funding rates, order books, klines, vault flows and mark-index spreads.

What you can do
  • Browse markets and symbols: futures and spot overviews, symbol universe with filters and precision rules
  • Inspect market microstructure: order books, klines by last/mark/index price, recent trades
  • Analyze funding: funding overview with per-market intervals and caps/floors, annualized funding screener
  • Screen TradFi perps (metals, energy, equities, treasuries, forex) and rank mark-vs-index divergence
  • Check open interest snapshots and vault deposit flows across Solana and optional EVM chains
  • Look up public account balance, open orders and fills for a given address
When to use it
Useful when you want an assistant to research Aster DEX markets, compare funding across mixed 1h-to-8h intervals, or watch 24/7 TradFi perpetuals and spot pairs without writing API code or holding keys.
Requirements
Runs locally as a Python package via uvx (Python tooling required); stdio by default, or a local HTTP mode on port 8904. No API keys or accounts. Network access to Aster public endpoints and Solana RPC; optional ASTER_EVM_RPC_URL (or per-chain variants) for EVM vault logs.
Before you install
All tools are read-only and keyless, but data comes from third-party public endpoints and can be stale or unavailable (cached responses carry age fields, null means not available). Account lookups only work for public addresses and often return privacy errors. EVM vault queries need your own RPC URL; free public RPCs reject them. Nothing here is trading advice.

Installation

In SourceWeft

  1. Open Aster Agent Gateway in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

aster-agent-gateway

[CI] [PyPI] [PyPI downloads] [MCP Catalog] [License: MIT] [Python 3.11+]

Aster lists roughly 580 futures, and about 32 of them are things you would not expect on a crypto DEX: gold, oil, treasuries, single equities and index perps that trade 24/7 while the underlying market sleeps. This MCP server puts the whole board, plus ~68 spot pairs, funding, order books, klines and vault deposit flows, in front of an AI agent. Read-only and keyless; public endpoints only (fapi.asterdex.com/fapi/v3, sapi.asterdex.com/api/v3, tapi.asterdex.com/info, Solana RPC, optional EVM RPCs), cached and rate-limited.

Use cases

Funding first, because this is where Aster is different. Intervals vary per market, 1h to 8h; annualize naively and an 8h market reads 8x too cold. The screener computes every row from its own interval and shows cap/floor next to it, so a 4,148%/yr print comes with the context that explains it.

Then the TradFi board at 3am: gold at $4,365 with live volume, oil paying longs to hold (negative funding, -0.0001%/1h when we looked), Micron up 4.8% overnight. One API, same conventions as the crypto rows.

mark_index_divergence ranks all ~756 markets by mark-vs-index spread. The morning we captured it, RTXUSDT topped both that board (505 bps rich) and the funding board at once, which is the classic pre-squeeze picture. Vault deposit flows show who parks capital where; OI snapshots are per-symbol and honest about the fact that Aster has no keyless OI history.

Full walkthroughs: examples/use-cases.md.

Quickstart

Claude Code:

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

stdio (default, for local agents):

bash
uvx aster-agent-gateway

or from a checkout:

bash
git clone https://github.com/alekskram/aster-agent-gatewaycd aster-agent-gatewayuv syncuv run aster-agent-gateway

Claude Desktop / Cursor config:

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

Hosted form, streamable HTTP on port 8904:

bash
uvx aster-agent-gateway --http             # 127.0.0.1:8904curl http://127.0.0.1:8904/health   # -> {"ok": true, "service": "aster-agent-gateway", ...}
Codex (~/.codex/config.toml)
toml
[mcp_servers.aster]command = "uvx"args = ["aster-agent-gateway"]
ZCode: register the server (copy-paste)
bash
# 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, osp = 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).

#ToolSignatureWhat it does
1market_overviewmarket_overview(limit=20, sort="volume")Futures panel from ONE ticker/24hr ALL call joined with exchangeInfo: TRADING markets, top volumes, status counts, fresh listings (onboardDate).
2exchange_symbolsexchange_symbols(venue="futures", symbol=None, include_junk=False)Symbol universe with filters/precisions incl. MIN_NOTIONAL, stepSize, leverageFilter; TEST*/SETTLING junk filtered by default.
3order_bookorder_book(symbol, venue="futures", depth=10)fapi depth / sapi api/v3 depth; limit snapped to a priced tier (weight-aware).
4klinesklines(symbol, interval="1h", limit=100, market="futures", price_type="last")last/mark/index klines on fapi; spot via sapi.
5tradestrades(symbol, limit=20, venue="futures")Fresh keyless trades; spot path probed live (honest error dict if dead).
6spot_overviewspot_overview(limit=20)Spot pairs from sapi ticker/24hr + exchangeInfo; TEST* junk filtered.
7funding_overviewfunding_overview(limit=20, sort="rate")All ~730 rates from premiumIndex + fundingInfo: mixed 1/2/4/8h intervals (flagged), cap/floor, interestRate, nextFundingTime.
8tradfi_marketstradfi_markets(limit=20, window=None)TradFi-perp screener by asset class (metals/equity/energy/treasuries/forex) + tradfi_crypto_corr sub-block: local TradFi-vs-BTC correlation from klines.
9funding_screenerfunding_screener(top=10, direction="both")One-call ranking by annualized funding, premium, mark-index spread + funding_regime headroom to cap/floor.
10oi_snapshotoi_snapshot(symbols=None, top=10)Per-symbol openInterest (max 10 symbols/call). No keyless OI history (404) - stated honestly.
11deposit_flowsdeposit_flows(chain_filter="all", limit=20)Solana vault signatures (keyless) + EVM vault Transfers when ASTER_EVM_RPC_URL* set + deposit_stats hourly/chain buckets.
12account_viewaccount_view(address, data="balance")tapi aster_getBalance/openOrders/userFills keyless for any address; privacy-empty returns an honest error dict explaining why.
13mark_index_divergencemark_index_divergence(limit=20)mark vs index spread screener from ONE premiumIndex call + markPriceKlines-vs-klines crosscheck on the top 3.

Why a gateway and not the raw API?

Aster's fapi/sapi/tapi endpoints are plain REST. The traps are in the semantics:

Raw API gives youYou would have to build
per-market funding intervals that differ (1h to 8h)correct annualization per symbol; a naive ×24×365 overstates 8h markets by 8×
funding cap/floor fields under live vs legacy namesname negotiation with fallback (this gateway reads fundingFeeCap/FundingFeeFloor and degrades honestly)
~580 symbols mixing crypto, TradFi 24/7 perps and spotchain/asset-class filtering, spot index dislocation ranking, capacity filtering where OI is not published
three separate API surfaces (futures/spot/tapi) + Solanaone tool surface with consistent symbol handling and per-field source tags

Rate limits

Two REST buckets, locally enforced and weight-aware:

  • fapi 2400 weight/min, sapi 6000/min (header X-MBX-USED-WEIGHT-1M read after every call). Above 80% of a bucket the client self-throttles; 429 backs off honoring Retry-After; a 418 (repeated 429 = IP ban) triggers a 60s refusal cooldown. Depth/kline limits snap to priced tiers so callers cannot accidentally burn weight.
  • Solana 10 req/min, tapi 30/min, EVM 20/min local budgets (separate ledgers, fail-fast honest errors).

TTL caches: exchangeInfo 3600s, fundingInfo 600s, premiumIndex and tickers 15s, depth 5s, klines 60s, trades 10s, openInterest 30s.

Data notes

  • Every numeric from the API is a STRING upstream; parsed with a never-raising helper - null always means "not available", never zero.
  • Every upstream failure returns an error dict {"error", "source", "reason"}, never a traceback.
  • No OI history exists keyless (/futures/data/openInterestHist 404s) - the gateway says so instead of inventing data.
  • EVM vault logs need ASTER_EVM_RPC_URL (or per-chain ASTER_EVM_RPC_URL_{BSC,ETH,ARB}); free public RPCs reject vault queries with -32005. Unset -> honest "no RPC configured".
  • tapi account privacy: most accounts are private; empty results are reported as privacy, not as data.
  • Cached responses carry age_seconds / fetched_at freshness fields.

Part of the suite

Four sibling read-only MCP gateways, one style: keyless, cached, honest degradation.

GatewayFocus
dydx-agent-gatewaydYdX v4: verified trader PnL, funding/OI anomaly detectors, leaderboard
arcus-agent-gateway194 tokenized US equities on Robinhood Chain: quotes, holders, whale transfers
hyperliquid-agent-gatewayHyperliquid: 233 perps + spot, funding carry, account risk, HyperEVM
aster-agent-gateway (you are here)Aster DEX: ~580 futures incl. 24/7 TradFi perps, funding caps/floors

All four are on glama.ai and PyPI; any of them installs with uvx <name>.

License

MIT.

Source: README.md at commit 6f9c622

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.1.3LatestSep 23, 2026
  2. v0.1.2Sep 22, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts