Tradingale

MCP Server Setup Guide

Connect Tradingale to your AI assistant to get Martingale Scores and market analysis directly in your conversations.

Claude DesktopClaude CodeCursorWindsurfCodexAny MCP Client

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants like Claude to connect to external tools and data sources. With Tradingale's MCP server, you can ask Claude about Martingale scores, search for instruments, and get market overviews without leaving your conversation.

Learn more about MCP

OFFICIAL

Listed on MCP Registry

Tradingale is officially published on the MCP Registry as io.github.tradingale/mcp. This means you can discover and install Tradingale directly from the official MCP server directory.

View on MCP Registry

Prerequisites

• 1.Tradingale Account - Sign up at tradingale.com/pricing
• 2.API Token - Generate one in Settings → API
• 3.MCP-compatible Client - Claude Desktop, Cursor, or another MCP client

Quick Setup (Claude Code CLI)

If you have Claude Code CLI installed, run this single command:

claude mcp add --transport http tradingale https://tradingale.com/mcp

Don't have Claude Code? Follow the manual setup below.

Manual Setup

Claude Desktop (Recommended)

Step 1: Download Claude Desktop

If you haven't already, download Claude Desktop from Anthropic:

Download Claude Desktop

Step 2: Get Your API Token

Go to Settings → API and copy your API token. You'll need this for the next step.

Step 3: Edit Claude Desktop Config

Open the config file with a text editor:

~/Library/Application Support/Claude/claude_desktop_config.json

Option 1: Streamable HTTP (Claude Desktop 0.8+)

For newer Claude Desktop versions. Your token is pre-filled if you're logged in:

{ "mcpServers": { "tradingale": { "url": "https://tradingale.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_TOKEN" } } } }

Option 2: Using mcp-remote (Older versions)

For older Claude Desktop versions (requires Node.js):

{ "mcpServers": { "tradingale": { "command": "npx", "args": [ "mcp-remote", "https://tradingale.com/mcp", "--header", "Authorization: Bearer YOUR_API_TOKEN" ] } } }

Step 4: Restart Claude Desktop

Completely quit Claude Desktop (⌘ + Q) and reopen it. It will connect to Tradingale automatically.

Verify Connection

After restarting, you should see a tools icon in the Claude Desktop chat input. Click it to see available Tradingale tools. Try asking: "What is the Martingale score for Bitcoin?"

Cursor IDE

Other MCP Clients

Available Tools

Once connected, you can use these tools by asking Claude naturally. Each tool has a weight that counts toward your monthly API limit.

get_instrumentWeight: 1

Get Martingale Score (0-5) and detailed analysis for a specific crypto or stock. Returns score breakdown, sequence parameters, and exchange availability.

Parameters: symbol (required), type (crypto|stock)

Example prompt: "What is the Martingale Score for BTC?"

search_instrumentsWeight: 3

Search and filter instruments by Martingale Score, Startingale, exchange, rounds, and other criteria. Returns a ranked list.

Parameters: type, min_martingale, min_startingale, exchange, rounds, limit

Example prompt: "Find crypto with Martingale Score >= 4"

list_top_cryptoWeight: 3

Get cryptocurrencies ranked by Martingale Score (0-5). Optionally filter by minimum Startingale.

Parameters: limit, min_startingale

Example prompt: "Show me the top 10 cryptocurrencies by Martingale Score"

list_top_stocksWeight: 3

Get stocks ranked by Martingale Score (0-5). Optionally filter by minimum Startingale.

Example prompt: "What are the top stocks by Martingale Score?"

crypto_overviewWeight: 5

Get top 5 cryptos ranked by Martingale Score (0-5), with their current Startingale readings.

Parameters: none

Example prompt: "Give me a crypto market overview"

stock_overviewWeight: 5

Get top 5 stocks ranked by Martingale Score (0-5), with their current Startingale readings.

Example prompt: "How do stocks look for the Tradingale model?"

market_overviewWeight: 10

Comprehensive overview: top instruments by Martingale Score (0-5) across crypto and stocks, with Startingale distribution.

Example prompt: "Give me a full market overview"

What You Can Ask

Tradingale provides martingale data through natural language queries. Click to copy example prompts:

"What's the Martingale Score for BTC?"

Returns: Score, Startingale compatibility, rounds, sequence parameters

"What's the martingale sequence for DOGE with $10,000?"

Returns: Round structure, price levels, quantity scaling breakdown

"Show me top crypto by Martingale Score"

Returns: Ranked list with scores and compatibility levels

"Give me a market overview"

Returns: Distribution of instruments by Startingale compatibility

AI Agent Use Cases

Build AI agents that retrieve martingale data. Tradingale provides the data, your agent decides how to use it.

Data Retrieval Agent

Uses get_instrument to fetch Martingale Scores for user queries. Returns structured data including score, compatibility, and sequence parameters.

Screening Agent

Uses search_instruments to filter instruments by score thresholds. Retrieve all instruments matching specific criteria like minimum Martingale Score.

Monitoring Agent

Uses crypto_overview to track Startingale distribution changes. Monitor how many instruments show each compatibility level over time.

Pair with Your Own Tooling

Tradingale supplies descriptive metrics only; it never places orders, holds funds, or gives advice. If you automate anything with the data, it happens in your own environment, on your own accounts:

Kraken CLI Binance APIAlpacaAny Exchange API

Example workflow:

1. 1. Query Tradingale: "What's the martingale sequence for ETH with $5,000?"
2. 2. Get: Round structure, price levels, quantity scaling per round
3. 3. Ask your preferred execution tool (Kraken CLI, etc.) to automate it

Usage & Billing

• • MCP calls count toward your monthly API quota using weighted pricing
• • Current quotas: Score Scout includes 5,000 weighted calls per month, Martingale Maestro includes 50,000 with a commercial license
• • Each tool has a different weight (1-10) based on the data returned
• • Monitor your usage in Settings → API
• • MCP usage appears in the "MCP" column of your daily usage table

Troubleshooting

Server not appearing in Claude Desktop?

Make sure you saved the config file and completely restarted Claude Desktop (not just closed the window). Check that the JSON syntax is valid and there are no trailing commas.

Authentication errors?

Verify your API token is correct and hasn't expired. You can generate a new token in Settings → API.

Rate limit exceeded?

You've reached your monthly API limit. Upgrade your plan or wait for the limit to reset at the beginning of next month.

Tools not working?

Try restarting your MCP client. If the issue persists, check the Tradingale status page or contact support.

Ready to Get Started?

Get your API token and start using Tradingale with Claude Desktop today.

Go to API Settings