TradeOnyx MCP server

TradeOnyx MCP Server

Connect TradeOnyx to Claude, ChatGPT, Gemini or any other MCP-capable assistant. Log trades by voice, have the assistant read your journal back to you, and let it ground its answers in your actual trading history instead of guessing.

TradeOnyx is a trading journal with pattern detection: it imports trades from 40 brokers and runs 28 detectors over your own history to surface what repeats in your trading. This repository documents its MCP server. It contains no product code.

49 tools · JSON-RPC 2.0 over HTTP · hosted in Germany

Endpoint

https://tradeonyx.io/mcp

Transport is HTTP with JSON-RPC 2.0. Authentication is a Bearer token in the Authorization header. The server implements initialize, tools/list and tools/call, and speaks protocol version 2025-06-18.

An unauthenticated call answers honestly rather than hanging:

curl -s -X POST https://tradeonyx.io/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# {"jsonrpc":"2.0","id":null,"error":{"code":-32001,"message":"Unauthorized"}}

Getting a token

free and asks for no payment details.

1. Create an account at tradeonyx.io. The account is

account can start it once. After it runs out the connector needs Pro or Pro Plus; the journal, the broker imports and the tax export stay free either way. A call made without an active trial or plan is refused with a message saying so, never with a silent empty result.

1. Open Settings → Integrations and start the 7-day connector trial. A free

stored, so a lost token cannot be recovered, only replaced.

1. On the same screen, create an MCP token.
2. Copy it immediately. The raw token is shown once; only a SHA-256 hash is

1. Revoke any token from the same screen at any time.

Tokens carry 256 bits of entropy. Treat one like a password: it grants the same access to your journal that you have.

Connecting an assistant

Any client that speaks MCP over HTTP works. For a client configured through a JSON file, the shape is:

{
  "mcpServers": {
    "tradeonyx": {
      "url": "https://tradeonyx.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Assistants that support remote MCP connectors directly (Claude's Connectors, for example) can add the endpoint through their own UI, including an OAuth flow, so no token needs to be pasted by hand.

What you can do with it

A few things people actually use it for:

1.0810, because the London range broke upward." The assistant fills the fields and writes the reasoning into the journal next to the trade.

• Log a trade in a sentence. "I bought 0.5 lots EURUSD at 1.0840, stop at

trades, asks what you were thinking, and files the answers as a journal entry.

• Write the evening review by talking. The assistant reads back the day's

and what did those trades have in common?" — grounded in your own rows, not in a guess.

• Ask what actually happened. "Which of my setups lost money this month,

before the open.

• Prepare the session. Pull the daily briefing and the planned playbooks

Tools

49 tools. 45 need an active connector trial, Pro or Pro Plus; the 4 bulk aggregations need Pro Plus. The Plan column below says which.

Daily tool-call caps, counted per UTC day and shown in the app:

A call over the cap comes back as a normal tool result with isError: true, naming the cap and when it resets, so an assistant can say what happened instead of failing silently. It is HTTP 200: a cap is a business rule, not a malformed request, and the specification's own worked example of a tool execution error is an upstream rate limit.

How errors arrive

Shortened. The full README is on GitHub.