MCP Server

The TradeSearcher MCP server gives Claude Code, Cursor, Codex, and other MCP-compatible agents a set of tools to search strategies and backtests, compare candidates, and read Pine source.

Configuration

Add this to your MCP client's config and replace your_api_key with a key from your account page:

{
  "mcpServers": {
    "tradesearcher": {
      "command": "npx",
      "args": ["-y", "@tradesearcher/mcp-server"],
      "env": {
        "TRADESEARCHER_API_KEY": "your_api_key"
      }
    }
  }
}

One-click install

• Cursor — Add to Cursor (edit the key afterwards)
• VS Code — Add to VS Code

Per-client setup

Claude Code

Claude Code is a terminal tool — add the server with one command:

claude mcp add tradesearcher --env TRADESEARCHER_API_KEY=your_api_key -- npx -y @tradesearcher/mcp-server

Then ask things like "Find strong BTCUSD swing backtests" or "Export the Pine source for this backtest."

Cursor / Codex / other clients

Use the one-click link above (Cursor) or paste the configuration into the client's mcp.json (Cursor, Codex, and most MCP clients read the same mcpServers shape).

Recommended flow

1. search_symbols — when the user gives a company name, partial ticker, or ambiguous symbol.
2. get_best_for_symbol — for a quick ranked shortlist.
3. search_backtests — when the user asks for filters like timeframe, market, or minimum metrics.
4. get_backtest with includeTrades / includeEquityCurve — only for selected candidates.
5. get_strategy — when the user asks how a strategy works or needs source code.
6. compare_backtests — to compare final candidates.

Responses include account and limits when relevant. If output is limited, the response carries the Premium upgrade link so the agent can explain what is missing.

Tools

Tool	Purpose
search_symbols	Map short inputs like AAPL to full symbols like NASDAQ:AAPL.
search_backtests	Search backtests by market, timeframe, and minimum metrics.
get_best_for_symbol	Get the top ranked backtests for a symbol.
get_backtest	Fetch one backtest, optionally with trades and equity curve.
get_strategy	Get strategy metadata and optional Pine source code.
compare_backtests	Compare selected backtests in compact form.
get_account_status	Show the current account tier, limits, and upgrade link.

search_backtests parameters

{
  "symbol": "string, optional",
  "market": "crypto | stock | forex | futures, optional",
  "timeframe": "string, optional",
  "strategyType": "intraday | swing | longTerm, optional",
  "minSharpe": "number, optional",
  "minProfitFactor": "number, optional",
  "maxDrawdown": "number, optional",
  "sort": "sharpe | sharpeRatio | profitFactor | roi | netProfitPercent | latestTradeDate | robustness, optional",
  "order": "desc | asc, optional",
  "limit": "number, optional"
}

get_backtest parameters

{
  "id": "number",
  "includeTrades": "boolean, optional",
  "tradeLimit": "number, optional; default 20 when includeTrades is true",
  "includeEquityCurve": "boolean, optional"
}

Source availability

get_strategy (and backtest/compare rows) report sourceAvailability:

• available — source text is available to this account with includeSourceCode: true. It does not guarantee the text is a complete standalone Pine strategy.
• no — source code is not available for this strategy.
• private — source exists but this account cannot view it.

Free vs Premium

Free accounts can run searches without a search-count limit, with limited result sets and details. Upgrade to Premium to expand the returned results and unlock the full details available to the account.