linker-trading-mcp

MCP server for the Linker Trading System — gives AI assistants access to trading strategies, positions, PnL analysis, and market data.

All requests proxy through the deployed Linker Trading API via the MCP protocol.

Quick Start

Add the following to your MCP client config:

{
  "mcpServers": {
    "linker-trading": {
      "command": "npx",
      "args": ["-y", "linker-trading-mcp@latest"],
      "env": {
        "API_KEY": "12345"
      }
    }
  }
}

Config file locations

| Client | Config file | |--------|-------------| | Claude Desktop | claude_desktop_config.json | | Cursor | .cursor/mcp.json | | Claude Code | .mcp.json (project root) or run: claude mcp add linker-trading --env API_KEY=12345 -- npx -y linker-trading-mcp@latest |

Environment Variables

| Variable | Required | Description | Default | |----------|----------|-------------|---------| | API_KEY | Yes | API authentication key (contact admin to obtain) | - | | API_BASE_URL | No | API endpoint (only if self-hosting) | http://admin.linker.net/trade-api |

Available Tools (23)

| Tool | Description | |------|-------------| | Strategy | | | list_strategies | List all trading strategies | | get_strategy_detail | Get detailed info for a strategy | | get_strategy_values | Get strategy value/performance data | | get_strategy_options | Get strategy dropdown options | | get_strategy_factors | Get factor weights for a strategy | | get_strategy_charts | Get chart data for a strategy | | generate_strategy_name | Auto-generate a strategy name | | Position | | | get_open_positions | Get all currently open positions | | get_closed_positions | Get historical closed positions | | get_position_owners | Get list of position owners | | PnL | | | get_pnl_summary | Get profit & loss summary | | get_pnl_details | Get detailed PnL breakdown | | get_pnl_historical | Get historical PnL data | | Market Data | | | get_latest_prices | Get latest commodity prices | | get_historical_prices | Get historical price data | | get_technical_indicators | Get technical indicators (MA, MACD, RSI, etc.) | | get_foreign_prices | Get foreign market real-time prices | | get_foreign_available | Get available foreign market data | | Economic | | | search_economic_indicators | Search for economic indicators | | get_economic_data | Get economic indicator time series | | Freight | | | search_freight_routes | Search shipping/freight routes | | get_freight_data | Get freight rate data | | Search | | | search_options | Search across all available options |

Architecture

AI Assistant (Claude / Cursor)
    ↓ MCP (stdio)
linker-trading-mcp          ← this package
    ↓ HTTP proxy
Linker Trading FastAPI       ← deployed at API_BASE_URL

License

MIT