get_active_symbolsLABSCO SUMMARY
Two read calls — status checks, not trading.
This is a narrow surface and honest about it: you can ask what is tradable and what your balance is, and nothing here places or cancels an order. That makes it a low-stakes thing to attach to an assistant while you build something larger against the Deriv API. Rate limits are Deriv's own, published with their API docs.
What it is
A small Python MCP server for the Deriv API, exposing two read calls to an MCP client such as Claude Desktop or Cline.
What you get
get_active_symbols— the list of trading symbols currently activeget_account_balance— the current balance on the account behind your token- Two install shapes: run it from a checkout with uv, or build the Docker image and let the client run the container
Requirements
A Deriv API token in DERIV_API_TOKEN, set in a .env file at the project root. Then either point the client at the project directory with uv, or build the image and have the client run it with docker run --rm -i.
Setup effort
One command plus a key — docker run --rm -i deriv-api-mcp, then supply credentials
USE CASES
01
Checking your balance mid-conversation
Ask for the account balance rather than switching to the Deriv interface to look.
02
Finding out what is tradable right now
Pull the active symbol list and have the assistant filter it to the market you care about.
03
Testing your token works
Run the balance call first — it is the shortest way to confirm the token in your env is valid.
2 tools
Listed in project docs. Your client may show a different list.
get_account_balanceBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- docker on PATH
- DERIV_API_TOKEN in your environment
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
docker run --rm -i deriv-api-mcpMCP Clients
Claude Desktop — uv
CLAUDE DESKTOP — UV · JSON
{
"mcpServers": {
"deriv-api-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/raju/Sites/deriv/mcp-deriv-api-server",
"run",
"server.py"
]
}
}
}The configuration on this page does not set DERIV_API_TOKEN; the project's instructions put it in a .env file. Check which folder the server reads that file from before you rely on it.
The path /Users/raju in the block above is on the machine of whoever wrote it, not on yours.
Claude Desktop — Docker
CLAUDE DESKTOP — DOCKER · JSON
{
"mcpServers": {
"deriv-api-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"deriv-api-mcp"
]
}
}
}The configuration on this page does not set DERIV_API_TOKEN; the project's instructions put it in a .env file. Check which folder the server reads that file from before you rely on it.
The path /Users/raju in the block above is on the machine of whoever wrote it, not on yours.
