Deriv API Server

A Model Context Protocol (MCP) server and OpenAI function calling service for interacting with the Deriv API.

Features

Active symbols list
Get Account Balance

Installation

Local Installation

curl -LsSf https://astral.sh/uv/install.sh | sh

Docker Installation

Build the Docker image:

docker build -t deriv-api-mcp .

Environment Setup

Create a .env file in your project root:

DERIV_API_TOKEN=your_api_key_here

Usage with Claude Desktop

Claude Desktop provides full support for MCP features. To use this server:

Install Claude Desktop
Add to your Claude Desktop configuration:
- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On cline VSCode: /Users/raju/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- On Windows: %APPDATA%\Claude\claude_desktop_config.json

For Local Installation

{
  "mcpServers": {
    "deriv-api-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/raju/Sites/deriv/mcp-deriv-api-server",
        "run",
        "server.py"
      ]
    }
  }
}

For Docker Installation

{
  "mcpServers": {
    "deriv-api-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "deriv-api-mcp"
      ]
    }
  }
}

Restart Claude Desktop

The server provides the following tools:

get_active_symbols: Get a list of active trading symbols
get_account_balance: Get the current account balance

Usage with OpenAI Function Calling

Rate Limits

Please refer to the Deriv API documentation for current rate limits and usage guidelines.

License

MIT

Deriv API MCP Server

Integrations