Skip to main content

What is the Decibel MCP server?

The Decibel MCP server implements the Model Context Protocol, allowing AI agents like Claude to trade on Decibel DEX programmatically. It exposes 25 tools covering:
  • Trading - Place and cancel orders (limit, market, stop, TWAP), close positions, set TP/SL
  • Market data - Prices, orderbook snapshots, market listings
  • Account management - Balances, positions, orders, and trade history
The MCP server requires a Node API token and an API wallet for trading operations. Get your API token from Geomi and create an API wallet at app.decibel.trade/api.
The MCP server is bundled with the Decibel CLI (@decibeltrade/cli). Installing the CLI gives you both the command-line interface and the MCP server.

Installation

Set up the MCP server with Claude Code, Claude Desktop, or other MCP clients.

Tool Reference

Full reference for all 25 tools with parameters and descriptions.

CLI Reference

The CLI exposes the same functionality for direct terminal use.

How it works

The MCP server runs as a local stdio process. An MCP-compatible client (like Claude Code or Claude Desktop) launches the server and communicates with it over stdin/stdout using the Model Context Protocol. Each MCP tool maps directly to a CLI action. The server validates inputs using Zod schemas, calls the Decibel SDK to execute on-chain transactions or query market data, and returns JSON results.
AI Agent <-> MCP Client <-> Decibel MCP Server <-> Decibel SDK <-> Aptos Blockchain

Available tools

The server exposes 25 tools organized into four categories:
CategoryToolsDescription
Trading5Limit, market, stop-limit, stop-market, TWAP
Order management6Close, cancel, cancel all, cancel TWAP, TP/SL set & cancel
Account queries9Positions, orders, balances, TWAPs, TP/SL, trade/order/funding/TWAP history
Market data3Markets list, price, orderbook
Configuration2Leverage, margin type
See the Tool Reference for complete details on each tool.