Cursor

Developer integration guide — connect GoldenClaw to Cursor via MCP.

Prerequisites

Setup

1. Add MCP Config

Create .cursor/mcp.json in your project root:

.cursor/mcp.json
{
  "mcpServers": {
    "goldenclaw": {
      "url": "https://stage.goldenclaw.sh/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your actual API key.

Global vs project config

This adds GoldenClaw to the current project only. For global access across all projects, go to Settings → MCP → Add Server and enter the same URL and headers.

2. Enable MCP (if needed)

Go to Settings → Features and make sure MCP is enabled.

3. Verify Connection

Open Cursor's AI chat (Cmd+L / Ctrl+L) and type:

"What's the current BTC/USDT price on Binance futures?"

You should see Cursor call the get_price tool and return the current price.

Example Prompts

"Calculate RSI for ETH/USDT on the 4h timeframe on Bybit"

"What are my open positions on Binance futures?"

"Show me Bollinger Bands for SOL/USDT on OKX"

"Analyze BTC/USDT: get price, RSI, and MACD on the 4h chart"

Available Tools

CategoryTools
Market Dataget_price, get_ohlcv, get_ticker, get_pairs, get_symbols, get_timeframes
Tradingplace_order, cancel_order, get_orders, get_positions, close_position
Accountget_balance, get_account
Analysiscalculate_indicator (35+ indicators)
Discoverylist_exchanges

See MCP Tools for full tool documentation.

Troubleshooting

"Connection refused" or "Server not found"

Check that the URL is exactly https://stage.goldenclaw.sh/mcp and the JSON file is valid.

"Unauthorized" error

Your API key may have expired or been revoked. Generate a new one from your Dashboard.

Tools not appearing

  1. Check that MCP is enabled in Settings → Features
  2. Restart Cursor after adding the config file
  3. Verify .cursor/mcp.json is in the project root, not a subdirectory