btse-mcp

# btse-mcp MCP server for the [BTSE](https://btse.com) Futures API. Enables AI agents (Claude Desktop, Cursor, LangChain) to query market data, manage positions, and place orders on BTSE via natural language. --- ## Prerequisites - **Python 3.11 or higher** — check with `python --version` - **pip** — check with `pip --version` - A BTSE account (testnet or live) > **Multiple Python versions (Anaconda etc):** use the full path explicitly: > ```bash > /usr/local/bin/python3.14 -m pip install -e . > /Library/Frameworks/Python.framework/Versions/3.14/bin/btse-mcp --help > ``` > Use that same full path in the Claude Desktop config (Step 4). --- ## Step 1 — Get API keys from BTSE ### Testnet (recommended first) 1. Register at https://testnet.btse.io 2. Go to **Account → API tab → New API** 3. Save the **API Key** and **Passphrase** — the passphrase is shown only once and is your `api_secret` 4. Set permissions: **Read** + **Trading** (add Transfer if needed) ### Live Same steps at https://btse.com --- ## Step 2 — Install ```bash # Clone the repo git clone https://github.com/xbotlive/btse-mcp.git cd btse-mcp # Install — adds `btse-mcp` command to your PATH pip install -e . # Verify btse-mcp --help ``` > **Virtualenv users:** if `btse-mcp` is not found after install, use the full path: > - macOS/Linux: `~/.venv/bin/btse-mcp` > - Windows: `~\.venv\Scripts\btse-mcp.exe` > > You will need this full path in the Claude Desktop config (Step 4). --- ## Step 3 — Configure accounts ```bash # Add a testnet account btse-mcp config --account-id testnet # Prompts: # API Key → paste your API key # API Secret → paste your passphrase (input is hidden) # Use testnet? [y/N] → y # Verify the connection — should print BTC-PERP last price btse-mcp test testnet # Add your live account when ready btse-mcp config --account-id main # Same prompts — answer 'n' to testnet # See all configured accounts btse-mcp list ``` Credentials are stored encrypted at `~/.config/bt…