Orderly Trading MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ORDERLY_BIN | No | Explicit path to the orderly CLI binary. Defaults to auto-discovery. If set and invalid, no fallback is used. | |
| ORDERLY_MCP_DEBUG | No | Set to enable logging of argv/timing to stderr. Defaults to off. | |
| ORDERLY_MCP_NETWORK | No | Default network override. If unset, the CLI config is used. | |
| ORDERLY_MCP_PROFILE | No | Tool surface/profile to expose: core, predict, algo, all, or full. | core |
| ORDERLY_MCP_READ_ONLY | No | Set to 1 to disable every mutation. Defaults to off. | |
| ORDERLY_MCP_MAX_OUTPUT | No | Maximum characters returned per call. | 65536 |
| ORDERLY_MCP_TIMEOUT_MS | No | Per-call timeout in milliseconds. | 30000 |
| ORDERLY_MCP_ALLOW_MAINNET | No | Set to 0 to block mainnet mutations. | true |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Orderly Network trading via the locally installed orderly CLI. Private keys live in the OS keychain; this server never sees them and never signs.
Call auth_list first when the account ID is unknown.
Before any mutating call, call it with dry_run=true when supported, show the user the exact request, then repeat with dry_run=false.
For tasks without a dedicated tool, call orderly_commands then orderly_run. Never guess argument names.
Symbols are uppercase, e.g. PERP_ETH_USDC. Predict round symbols come from predict_rounds; never construct or reuse one.
Key, wallet and auth management is not available here; ask the user to use the CLI directly.
Profile: core. Read-only: no. Network default: testnet.
No compatible "orderly" CLI found (need v2.0.1+).
/app/node_modules/.bin/orderly: not found
/usr/lib/node_modules/pnpm/dist/node-gyp-bin/orderly: not found
/usr/local/sbin/orderly: not found
/usr/local/bin/orderly: not found
/usr/sbin/orderly: not found
/usr/bin/orderly: not found
/sbin/orderly: not found
/bin/orderly: not found
/root/.local/bin/orderly: not found
/root/.cargo/bin/orderly: not found
Install the CLI: curl -fsSL https://orderly.network/cli.sh | sh
If it is installed outside this process's PATH, set ORDERLY_BIN in the MCP client configuration, for example: "ORDERLY_BIN=/home/you/.local/bin/orderly".
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| orderly_statusA | Report why the Orderly CLI is unavailable and how to fix it. The trading tools are disabled until a compatible orderly CLI (v2.0.1+) is found. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Orderly CLI schema | Machine-readable manifest of every installed CLI command, argument and mutates flag. |
| Stored Orderly accounts | Accounts stored in the OS keychain for testnet and mainnet (public account IDs only). |
| Effective MCP configuration | CLI binary, versions, profile, network, safety gates and limits. Never contains secrets. |
| Orderly trading guide | Setup, preview-then-execute flow, perps vs Predict, escape hatch and error codes. |
TDQS
Scored across 1 tool
With only a single tool exposed, there is no possibility of overlap or misselection. An agent cannot confuse orderly_status with anything else because nothing else exists.
The lone tool uses a clear, predictable snake_case server-prefixed convention (orderly_status). No mixed styles or verb inconsistencies can arise from a single-name surface.
A server named 'Orderly Trading MCP' exposes exactly one diagnostic tool and zero trading operations. This is an extreme mismatch between the stated purpose and the actual surface, effectively a stub rather than a functional toolset.
There are no trading capabilities at all—no order placement, cancellation, position queries, or market data. The only tool reports that the CLI is unavailable, leaving every conceivable trading workflow as a dead end.