MCP Server Setup Guide
Connect Tradingale to your AI assistant to get Martingale Scores and market analysis directly in your conversations.
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 MCPListed 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 RegistryPrerequisites
- 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
Step 1: Download Claude Desktop
If you haven't already, download Claude Desktop from Anthropic:
Download Claude DesktopStep 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:
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?"
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 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 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"
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"
Get stocks ranked by Martingale Score (0-5). Optionally filter by minimum Startingale.
Parameters: limit, min_startingale
Example prompt: "What are the top stocks by Martingale Score?"
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"
Get top 5 stocks ranked by Martingale Score (0-5), with their current Startingale readings.
Parameters: none
Example prompt: "How do stocks look for the Tradingale model?"
Comprehensive overview: top instruments by Martingale Score (0-5) across crypto and stocks, with Startingale distribution.
Parameters: none
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:
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 Execution Tools
Tradingale provides martingale intelligence. Pair with execution tools to build your own workflows:
Example workflow:
- 1. Query Tradingale: "What's the martingale sequence for ETH with $5,000?"
- 2. Get: Round structure, price levels, quantity scaling per round
- 3. Ask your preferred execution tool (Kraken CLI, etc.) to automate it
Usage & Billing
- • MCP calls count toward your monthly API limit using weighted pricing
- • 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