Quickstart
Install the Delta Exchange MCP server and connect your AI client in two minutes.
You need two things: a way to run the server (uvx), and your client's config
file. Market-data tools work immediately with no key. Add an API key only for
account tools.
1. Install uv
The server is distributed on PyPI and run with uv
via uvx, which downloads and runs it in an isolated environment. No manual
pip install needed.
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"Verify the server resolves:
uvx delta-exchange-mcp --help2. (Optional) Create an API key
Skip this if you only want public market data. For account reads, create a Read Data API key; to place orders, create a Trading key (see Authentication). You will set these environment variables:
| Variable | Value |
|---|---|
DELTA_API_KEY | your API key |
DELTA_API_SECRET | your API secret |
DELTA_MCP_ENV | india_prod (production) or india_testnet |
Leave trading off for now — the configs below are read-only. Turn it on in step 5 once reads work.
3. Configure your client
Pick your client. Replace the placeholders with your own credentials, or omit
the env block entirely for market-data-only use.
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or
%APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude:
{
"mcpServers": {
"delta-exchange": {
"command": "uvx",
"args": ["delta-exchange-mcp"],
"env": {
"DELTA_API_KEY": "your_read_only_key",
"DELTA_API_SECRET": "your_read_only_secret",
"DELTA_MCP_ENV": "india_prod"
}
}
}
}claude mcp add delta-exchange \
-e DELTA_API_KEY=your_read_only_key \
-e DELTA_API_SECRET=your_read_only_secret \
-e DELTA_MCP_ENV=india_prod \
-- uvx delta-exchange-mcpAdd to ~/.codex/config.toml:
[mcp_servers.delta-exchange]
command = "uvx"
args = ["delta-exchange-mcp"]
env = { DELTA_API_KEY = "your_read_only_key", DELTA_API_SECRET = "your_read_only_secret", DELTA_MCP_ENV = "india_prod" }Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"delta-exchange": {
"command": "uvx",
"args": ["delta-exchange-mcp"],
"env": {
"DELTA_API_KEY": "your_read_only_key",
"DELTA_API_SECRET": "your_read_only_secret",
"DELTA_MCP_ENV": "india_prod"
}
}
}
}Edit .vscode/mcp.json in your workspace:
{
"servers": {
"delta-exchange": {
"type": "stdio",
"command": "uvx",
"args": ["delta-exchange-mcp"],
"env": {
"DELTA_API_KEY": "your_read_only_key",
"DELTA_API_SECRET": "your_read_only_secret",
"DELTA_MCP_ENV": "india_prod"
}
}
}
}Edit ~/.config/zed/settings.json:
{
"context_servers": {
"delta-exchange": {
"command": {
"path": "uvx",
"args": ["delta-exchange-mcp"],
"env": {
"DELTA_API_KEY": "your_read_only_key",
"DELTA_API_SECRET": "your_read_only_secret",
"DELTA_MCP_ENV": "india_prod"
}
}
}
}
}Edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"delta-exchange": {
"command": "uvx",
"args": ["delta-exchange-mcp"],
"env": {
"DELTA_API_KEY": "your_read_only_key",
"DELTA_API_SECRET": "your_read_only_secret",
"DELTA_MCP_ENV": "india_prod"
}
}
}
}Config shapes change
Client config formats drift. If a block above doesn't load, check your client's current MCP docs and the server's upstream README.
4. Verify it works
Restart your client and send a prompt that needs no key:
Using the Delta Exchange tools, show the current BTCUSD ticker: last price,
24h change, and funding rate.If you configured a key, confirm account access:
List my open positions on Delta and their unrealised PnL.5. (Optional) Enable trading
To let the server place and manage orders, add DELTA_MCP_MODE=trade to the
env block and use a key with Trading permission (and an IP whitelist). For
example, with Claude Code:
claude mcp add delta-exchange \
-e DELTA_API_KEY=your_trading_key \
-e DELTA_API_SECRET=your_trading_secret \
-e DELTA_MCP_ENV=india_prod \
-e DELTA_MCP_MODE=trade \
-- uvx delta-exchange-mcpFor the JSON clients, add "DELTA_MCP_MODE": "trade" to the env object shown
above (in Codex, use TOML: add DELTA_MCP_MODE = "trade" inside its env = { … }). Restart your client, then verify with a dry run (nothing is sent):
Dry-run a reduce-only limit sell of 1 BTCUSD contract at 90000. Show me the
payload before sending.Trading is real
With trade mode on, the server can place live orders. Always dry-run first; every
mutation is written to an audit log at ~/.delta-exchange-mcp/audit/. See
Trading tools and Security.
Next: browse the Use Cases or the full Tool Reference.