Deriv API

Provides access to Deriv active symbols and account balance via MCP tools.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You operate a Deriv API MCP server that lets you interact with the Deriv API from your MCP-enabled clients. It exposes actions like listing active symbols and checking your account balance, enabling you to build conversational or automation flows that respond to live Deriv data and account state.

How to use

To use this MCP server with your MCP client, connect to the local or Docker-hosted server and call the available tools. You can retrieve the list of active trading symbols and inquire your current account balance. Use the MCP client’s standard tool invocation flow to call get_active_symbols and get_account_balance, then render the results in your app or chat.

How to install

Prerequisites you need before installation: a supported runtime environment (Python for the server), and access to a terminal or shell. You also have the option to run the server in a Docker container for isolation.

# Local installation (one-liner installer)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Docker installation (build the image locally)
docker build -t deriv-api-mcp .

Environment setup creates a configuration file to provide your Deriv API token to the server.

# Create environment file
DERIV_API_TOKEN=your_api_key_here

Optional: provide a local configuration for Claude Desktop or other MCP clients to run the server in either local or Docker mode.

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

Additional configuration and notes

Environment variables you set in the project root will be accessible to the server. Create a .env file at the project root and include your Deriv API token. The MCP client can read this token to authorize requests to the Deriv API.

If you prefer running the server with Docker, build the image first and then run it to start listening for MCP requests. The Docker path provides an isolated environment for the server and its dependencies.

Important: you can reset or rotate your Deriv API token as needed, and keep the token in a secure location. Do not share your token in logs or public channels.

Claude Desktop configuration

To use the MCP server with Claude Desktop, add the server entry to Claude Desktop’s MCP configuration so you can invoke its tools directly from Claude.

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

Tools available

The MCP server exposes two primary tools you can call from your client:

get_active_symbols: Retrieve the list of active trading symbols available for trading
get_account_balance: Retrieve the current account balance for your Deriv account

Server connection configurations (MCP)

The server can be accessed through local stdio commands for development or via a Docker container for deployment.

Available tools

get_active_symbols

Fetches the list of currently active trading symbols available from Deriv and suitable for trading.

get_account_balance

Retrieves the current account balance for the associated Deriv account.