Aster MCP Server

An Model Context Protocol server for Aster Futures and Spot APIs, enabling AI agents (e.g. Cursor, Claude, LangChain) to securely query market data, place orders, and check positions and accounts.

Features

• Config & security: Multi-account, local Fernet-encrypted API key storage (~/.config/aster-mcp/)

• Auth: HMAC (API Key/Secret) and V3 key signing (EIP-712, user/signer/private_key; see aster-finance-futures-api-v3)

• MCP tools:

  • Futures: Market data, account/positions, place/cancel orders, leverage & margin, transfers, income, commission rate, leverage bracket

  • Spot: Market data, account, place/cancel orders, trades, transaction history, commission rate, spot–futures transfer

• CLI: config / list / start / stop / status / test / backup

Installation

pip install -e .
# or
pip install git+https://github.com/asterdex/aster-mcp.git

Quick start

# 1. Configure account (interactive, default HMAC)
aster-mcp config

# V3 key-signing account (EIP-712)
aster-mcp config --account-id main --auth-type v3

# 2. List accounts
aster-mcp list

# 3. Start MCP service (default stdio for Cursor/Claude)
aster-mcp start

# 4. Test connection
aster-mcp test main

Using with Cursor

1. Configure at least one account with aster-mcp config.

2. Add Aster MCP in Cursor’s MCP settings; command example:

   • python -m aster_mcp.simple_server (use a Python environment where aster_mcp is installed).

3. Use natural language in chat (e.g. “get Aster BTC price”, “place an Aster order”).

Tool list (summary)

Full parameters and integration details: Aster-MCP External Integration Guide.

Project structure

aster-mcp/
├── aster_mcp/
│   ├── __init__.py
│   ├── config.py       # Config & encryption
│   ├── client.py       # Aster FAPI client (futures, HMAC)
│   ├── v3_client.py    # Aster FAPI v3 client (EIP-712)
│   ├── spot_client.py  # Aster SAPI client (spot)
│   ├── tools.py        # MCP tool implementations
│   ├── simple_server.py
│   └── cli.py
├── docs/
│   └── Aster-MCP-External-Integration.md
├── tests/
├── pyproject.toml
├── requirements.txt
└── README.md

Relation to Aster APIs

• This repo includes Aster FAPI (client.py, futures) and SAPI (spot_client.py, spot) clients.

• Auth:

  • HMAC: API Key/Secret for /fapi/v1, /fapi/v2, etc.

  • V3 key signing: user (main wallet), signer (API wallet), private_key (signer key), EIP-712; for /fapi/v3. Requires eth-account.

• Futures base URL: https://fapi.asterdex.com; Spot base URL: https://sapi.asterdex.com (overridable per account in config).

• API docs: aster-finance-futures-api, aster-finance-futures-api-v3, aster-finance-spot-api.

Risk and compliance

• Futures trading involves risk; verify in a test environment first.

• API keys are stored locally with encryption; do not leak or commit them.

• Comply with local regulations and Aster platform terms.

License

MIT