@volaticloud/mcp-server

MCP (Model Context Protocol) server for the VolatiCloud GraphQL API. Lets AI agents manage strategies, bots, exchanges, and backtests through natural language.

Quick Start

npx -y @volaticloud/mcp-server

Prerequisites

1. A VolatiCloud account with an organization
2. An API client (create one at Organization > API Keys in the dashboard)

Configuration

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "volaticloud": {
      "command": "npx",
      "args": ["-y", "@volaticloud/mcp-server"],
      "env": {
        "VOLATICLOUD_ENDPOINT": "https://api.volaticloud.com/gateway/v1/query",
        "VOLATICLOUD_CLIENT_ID": "<your-client-id>",
        "VOLATICLOUD_CLIENT_SECRET": "<your-client-secret>"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "volaticloud": {
      "command": "npx",
      "args": ["-y", "@volaticloud/mcp-server"],
      "env": {
        "VOLATICLOUD_ENDPOINT": "https://api.volaticloud.com/gateway/v1/query",
        "VOLATICLOUD_CLIENT_ID": "<your-client-id>",
        "VOLATICLOUD_CLIENT_SECRET": "<your-client-secret>"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | VOLATICLOUD_CLIENT_ID | Yes | — | API client ID | | VOLATICLOUD_CLIENT_SECRET | Yes | — | API client secret | | VOLATICLOUD_ENDPOINT | No | https://api.volaticloud.com/gateway/v1/query | GraphQL endpoint URL |

Available Tools

Static Tools

| Tool | Description | |------|-------------| | introspect_schema | Explore the API schema, optionally drill into a specific type | | search_schema | Search types, fields, and enums by keyword | | execute_graphql | Run any GraphQL query or mutation with variables |

Dynamic Tools (auto-generated)

The server introspects the GraphQL schema at startup and generates individual tools for each query and mutation. Examples:

• strategies, bots, exchanges, runners — List resources
• create_strategy, create_bot, create_exchange — Create resources
• update_strategy, update_bot — Update resources
• delete_strategy, delete_bot — Delete resources
• start_bot, stop_bot, restart_bot — Bot lifecycle
• run_backtest, run_simulation — Run analysis
• get_bot_open_positions, get_bot_trading_config — Live data

How It Works

1. On startup, authenticates using your API client credentials (OAuth2 client_credentials flow)
2. Introspects the GraphQL schema to discover all available operations
3. Generates MCP tool definitions from each query and mutation
4. Communicates with AI agents via stdio (standard MCP transport)
5. Automatically refreshes the access token before expiry

Development

cd mcp-server
npm install
npm run build
node dist/index.js