Skip to main content

What it exposes

The MCP server gives AI tools access to Joyride through:
  • market-data tools
  • trading tools
  • account tools
  • analysis tools
  • resources and prompts for portfolio and market workflows

Local stdio mode

Point your MCP client at the built server entry point:
{
  "mcpServers": {
    "joyride": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp-server/dist/index.js"],
      "env": {
        "JOYRIDE_GATEWAY_URL": "wss://api.joyride.exchange/gateway",
        "JOYRIDE_HTTP_URL": "https://api.joyride.exchange/engine",
        "JOYRIDE_USER_ID": "your-user-id"
      }
    }
  }
}

Remote HTTP mode

Joyride also has an HTTP MCP entry point intended for remote agent access:
  • base URL: https://api.joyride.exchange/mcp
  • transport: Streamable HTTP
  • auth: bearer token / API key mapping on the server side

Typical use cases

  • list available options chains
  • fetch quotes and order books
  • place and cancel paper-trading orders
  • inspect balances, positions, and history
  • ask an AI client to analyze a position or build a trade idea

Safety note

Keep trade-mutating tools behind explicit approval if you move beyond paper trading.