Aster Finance

You set up the Aster Finance MCP Server to expose market data, trading actions, and account information via a standard MCP interface. This lets AI agents and MCP-compatible clients interact with the Aster Futures API through RESTful endpoints, while keeping credentials secure and integrating easily with your MCP host.

How to use

You run the MCP server as a local stdio process and connect your MCP client to it using the server name you configure (in this case, the aster server). You can request market data such as order books, trades, klines, and ticker information, as well as perform trading operations like placing or canceling orders and querying balances. All API credentials are supplied through environment variables, so your client never handles secret keys directly.

How to install

Prerequisites: you need Node.js installed on your machine, along with a package manager (npm or pnpm). Ensure you have permission to install dependencies and build the project.

Install dependencies and build the server with npm:

npm install
npm run build

Or install dependencies and build with pnpm:

pnpm install
pnpm run build

Create an MCP host configuration that launches the server as a stdio process and provides your API credentials via environment variables. The following configuration snippet shows how to set this up.

{
  "mcpServers": {
    "aster": {
      "command": "node",
      "args": [
        "/path/to/your/aster-mcp-server/build/index.js"
      ],
      "env": {
        "ASTER_API_KEY": "YOUR_ASTER_API_KEY",
        "ASTER_API_SECRET": "YOUR_ASTER_SECRET_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Additional sections

Configuration and security are important for a robust deployment. The server uses API keys stored in environment variables, keeping secrets out of code and configuration files. Your MCP host will start the server via a stdio transport and pass credentials securely at runtime.

Usage notes and examples show how to connect your MCP client to the local server, perform market data queries, and execute trading actions. Ensure your MCP host is configured to launch the aster server with the correct environment variables before attempting to query data or place orders.

Troubleshooting tips: verify that the environment variables ASTER_API_KEY and ASTER_API_SECRET are correctly set in the MCP host configuration, confirm the path to the built index.js is accurate, and check that the node process is running. If you encounter connectivity issues, ensure the MCP host can reach the server and that the server is not blocked by firewall rules.

Available tools

ping

Test connectivity to the Rest API.

time

Get the current server time.

exchangeInfo

Get current exchange trading rules and symbol info.

depth

Get the order book for a symbol.

trades

Get recent market trades.

historicalTrades

Get older market historical trades.

aggTrades

Get compressed, aggregate market trades.

klines

Get Kline/candlestick bars for a symbol.

indexPriceKlines

Get Kline/candlestick bars for the index price.

markPriceKlines

Get Kline/candlestick bars for the mark price.

premiumIndex

Get Mark Price and Funding Rate.

fundingRate

Get funding rate history.

fundingInfo

Get funding rate configuration.

ticker_24hr

24-hour rolling window price change statistics.

ticker_price

Get the latest price for a symbol or symbols.

ticker_bookTicker

Get the best price/qty on the order book.

setPositionMode

Change user's position mode (Hedge vs. One-way).

getPositionMode

Get user's current position mode.

setMultiAssetsMode

Change user's Multi-Assets mode.

getMultiAssetsMode

Get user's current Multi-Assets mode.

placeOrder

Send in a new order.

placeBatchOrders

Place multiple orders at once.

transferAsset

Transfer assets between futures and spot accounts.

queryOrder

Check an order's status.

cancelOrder

Cancel an active order.

cancelAllOpenOrders

Cancel all open orders on a symbol.

cancelBatchOrders

Cancel multiple orders.

countdownCancelAll

Auto-cancel all open orders after a countdown.

queryOpenOrder

Query a specific open order.

getAllOpenOrders

Get all open orders on a symbol.

getAllOrders

Get all account orders (active, canceled, or filled).

getBalance

Get futures account balance.

getAccountInfo

Get current account information.

setLeverage

Change initial leverage for a symbol.

setMarginType

Change margin type (ISOLATED/CROSSED).

modifyPositionMargin

Modify isolated position margin.

getPositionMarginHistory

Get position margin change history.

getPositionInfo

Get current position information.

getTradeList

Get trades for a specific account and symbol.

getIncomeHistory

Get income history.

getLeverageBrackets

Get notional and leverage brackets.

getAdlQuantile

Get Position ADL Quantile Estimation.

getForceOrders

Get user's force orders (liquidations/ADL).

getCommissionRate

Get user's commission rate for a symbol.