AEVO

You can run the AEVO MCP Server to enable trading interactions with Claude Code, Claude Desktop, or any MCP client. It provides a programmable interface for order placement, account queries, and market data, enabling automated trading workflows and testing against AEVO.

How to use

To use the AEVO MCP Server, start the server and connect your MCP client using the provided HTTP endpoint or the local stdio transport. You can test basic connectivity with a ping command and then perform common actions such as checking balances, registering accounts, or placing and canceling orders.

How to install

Prerequisites: you need Python with pip and Docker installed on your machine. You also need access to AEVO credentials to authorize API requests.

# 1. Quick start using Docker and Claude Code
git clone https://github.com/ribbon-finance/aevo-mcp.git
cd aevo-mcp
cp .env.example .env

# Edit your AEVO credentials in .env
# AEVO_API_KEY=your_key
# AEVO_API_SECRET=your_secret
# AEVO_SIGNING_KEY_PRIVATE_KEY=your_signing_key

docker compose up --build -d

# Connect Claude Code
claude mcp add --transport http aevo-trading http://localhost:8080/mcp

# Test connectivity
# In Claude Code, run: call the ping tool

Additional content

Configuration tips, security considerations, and practical usage notes follow to help you run and maintain the AEVO MCP Server effectively.

Alternative setup options are also available if you prefer a local Python install or want to use Claude Desktop for MCP integration.

Notes on environment and tools

The server exposes a variety of tools for trading and account management, along with prompts to guide planning and onboarding.

Troubleshooting and tips

If you encounter connection issues, verify that the server is running and that the correct MCP transport and URL are configured in your client. Ensure your AEVO credentials are valid and that environment variables are loaded into the process.

Available tools

markets

Query market data such as summaries, order books, and price data.

account

Access account details, balances, and portfolio information.

portfolio

View and manage your portfolio composition and allocations.

positions

Inspect open positions and exposure.

orderbook

Access the current order book and market depth.

build_order

Create an order payload based on your trading plan.

create_order

Submit a new order to the AEVO trading system.

cancel_order

Cancel a specific order by its identifier.

cancel_all

Cancel all open orders under your account.

register_account

Register a new AEVO account using provided keys.

trade_plan

Prompt to generate a trading plan based on market data and preferences.

risk_checklist

Prompt to assess risk factors before executing trades.

cancel_plan

Prompt to plan safe exit or reduction of exposure.

onboarding_plan

Prompt to guide new users through setup and authentication.