trackr-mcp

MCP server for the ForexTrackr read-only API. On startup it loads the API's public OpenAPI spec (/api/public/docs.json) and exposes every operation your API key may call as a tool (account lookup, current session, dashboard, executive, operations, payments, retention, sales, management).

Get an API key from a ForexTrackr admin (Admin Settings > User Management > API Keys). Tools outside the key's scopes answer 401.

Install (Claude Code plugin)

Requires Node.js 20+. In Claude Code:

/plugin marketplace add jakuubkoo/trackr-mcp
/plugin install trackr@forextrackr

Claude Code asks for your ForexTrackr address and API key when the plugin is enabled (firm 1, plus an optional firm 2) and keeps the keys in the system keychain (~/.claude/.credentials.json on Linux). Change them later with /plugin configure trackr@forextrackr, then restart Claude Code. Updates: /plugin marketplace update forextrackr.

Related MCP server: stonex-mcp

Several firms

Each firm is a ForexTrackr instance with its own address and key. Ask Claude "which firms do I have?" or "switch to firm2": the switch_firm tool lists the firms and switches every tool to another one; the choice is kept across restarts. More firms than the two in the plugin settings: "log in to firm3 at https://... with trk_..." (the login tool saves it under that name), logout forgets one.

Claude Desktop or without the plugin

Clone the repository and point the client at dist/index.js (no npm install needed):

{
  "mcpServers": {
    "trackr": { "command": "node", "args": ["/path/to/trackr-mcp/dist/index.js"] }
  }
}

Development

npm install, edit index.js, then npm run build and commit dist/index.js with it (the plugin runs the bundle).

Sign in without the plugin

Claude Desktop or a cloned copy: tell Claude "log in to ForexTrackr at https://... with trk_..." once. The login tool checks the key and saves it with the address in ~/.config/trackr-mcp/config.json (readable only by you); logout deletes the key. TRACKR_FIRM1_URL / TRACKR_FIRM1_API_KEY (and FIRM2) environment variables work too; TRACKR_URL / TRACKR_API_KEY set firm1.

Dates are YYYY-MM-DD, and to includes its own day. Some tools are precomputed once a night and answer only the preset ranges their description lists.

The overrides table in index.js corrects the generated tools: it hides misleading or duplicate ones (the *_all concatenations, the 5 MB balances list, leverage distribution), drops ignored parameters, trims large payloads and says in each description whose P&L a figure is (broker or client).

License

MIT