{"_id":"@tradesearcher/mcp-server","_rev":"2-3e2590f6ce26eebe3ceeefcee33c6082","name":"@tradesearcher/mcp-server","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@tradesearcher/mcp-server","version":"0.1.0","keywords":["tradesearcher","trading","backtesting","mcp","claude-code","codex","agents"],"license":"MIT","_id":"@tradesearcher/mcp-server@0.1.0","maintainers":[{"name":"vnguyen42","email":"contact@nguyenvincent.com"}],"homepage":"https://github.com/vnguyen42/tradesearcher-agent-tools#readme","bugs":{"url":"https://github.com/vnguyen42/tradesearcher-agent-tools/issues"},"bin":{"tradesearcher-mcp":"src/index.js"},"dist":{"shasum":"99c0f990ca4e5c920b4ba4ed20eafeb893fb433d","tarball":"https://registry.npmjs.org/@tradesearcher/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":3,"integrity":"sha512-YUvOJBN4WPxfrCLt+agR2Izta8wj0KosZ96CE3EngabN/A6VANUPw58beHyB2zhP3uB55cqL4qnF/PiBNV2sLQ==","signatures":[{"sig":"MEYCIQDmrRBod9YI5M/zP0OIFftjU06p+c4hUHh+yGgOMPvCGAIhAJQvEvPs0KDge5HbKaMcMaReuqb2ptx9K1cXBVuihqyv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9007},"type":"module","engines":{"node":">=18"},"gitHead":"61c3dd6c9e596d872bd6838e2c33df25b327af10","scripts":{"build":"node --check src/index.js","prepack":"npm run build"},"_npmUser":{"name":"vnguyen42","email":"contact@nguyenvincent.com"},"repository":{"url":"git+https://github.com/vnguyen42/tradesearcher-agent-tools.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.4","description":"TradeSearcher MCP server for Claude Code, Codex, and other agents","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@tradesearcher/core":"0.1.0","@modelcontextprotocol/sdk":"^1.18.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1781991425017_0.017496644408711015","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@tradesearcher/mcp-server","version":"0.1.1","mcpName":"ai.tradesearcher/mcp-server","description":"TradeSearcher MCP server for Claude Code, Codex, and other agents","type":"module","license":"MIT","homepage":"https://github.com/vnguyen42/tradesearcher-agent-tools#readme","repository":{"type":"git","url":"git+https://github.com/vnguyen42/tradesearcher-agent-tools.git","directory":"packages/mcp-server"},"bugs":{"url":"https://github.com/vnguyen42/tradesearcher-agent-tools/issues"},"keywords":["tradesearcher","trading","backtesting","mcp","claude-code","codex","agents"],"bin":{"tradesearcher-mcp":"src/index.js"},"scripts":{"build":"node --check src/index.js","prepack":"npm run build"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.18.0","@tradesearcher/core":"0.1.0"},"engines":{"node":">=18"},"_id":"@tradesearcher/mcp-server@0.1.1","gitHead":"677be8f410ac4ea003a0a7a67f92239cd58ec79c","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-+5eZCqF3BYpCy4lR03QdGSda7879rXzd+SvOgOttj2aIDV+UgnMrlHxLJdfNlNux+pXxrjfs1v4BefAIkuzazg==","shasum":"da81fa85394caa25486990f1d25d3fee8fae7b0a","tarball":"https://registry.npmjs.org/@tradesearcher/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":3,"unpackedSize":9460,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGCWBM7Rx4hQnBLHtrNyehXJGUuNBxyWTAHnHC5EuDluAiEArs16YZiKUsS+eI58arSHcL4pJtqP7Lj7aEkSDFPwNcI="}]},"_npmUser":{"name":"vnguyen42","email":"contact@nguyenvincent.com"},"directories":{},"maintainers":[{"name":"vnguyen42","email":"contact@nguyenvincent.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.1_1784824715045_0.7785239032426183"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-20T21:37:04.870Z","modified":"2026-07-23T16:38:35.330Z","0.1.0":"2026-06-20T21:37:05.145Z","0.1.1":"2026-07-23T16:38:35.182Z"},"bugs":{"url":"https://github.com/vnguyen42/tradesearcher-agent-tools/issues"},"license":"MIT","homepage":"https://github.com/vnguyen42/tradesearcher-agent-tools#readme","keywords":["tradesearcher","trading","backtesting","mcp","claude-code","codex","agents"],"repository":{"type":"git","url":"git+https://github.com/vnguyen42/tradesearcher-agent-tools.git","directory":"packages/mcp-server"},"description":"TradeSearcher MCP server for Claude Code, Codex, and other agents","maintainers":[{"name":"vnguyen42","email":"contact@nguyenvincent.com"}],"readme":"# @tradesearcher/mcp-server\n\nMCP server for Claude Code, Codex, Cursor, and other coding agents.\n\nDocs: <https://docs.tradesearcher.ai/developer-tools/mcp-server> · Create an API key: <https://tradesearcher.ai/app/account/my-account#agent-api-keys>\n\n```bash\nnpx -y @tradesearcher/mcp-server\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"tradesearcher\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@tradesearcher/mcp-server\"],\n      \"env\": {\n        \"TRADESEARCHER_API_KEY\": \"your_api_key\"\n      }\n    }\n  }\n}\n```\n\nTool responses include simple limit text and the Premium upgrade link when the account is limited.\n\n## Common tool calls\n\nSearch symbols before searching backtests when the user gives a company name or ambiguous ticker:\n\n```json\n{\n  \"name\": \"search_symbols\",\n  \"arguments\": { \"query\": \"Apple\", \"limit\": 5 }\n}\n```\n\nFind top candidates:\n\n```json\n{\n  \"name\": \"get_best_for_symbol\",\n  \"arguments\": { \"symbol\": \"AAPL\", \"limit\": 5 }\n}\n```\n\nInspect one backtest without flooding context. `includeEquityCurve` can return thousands of points, so use it after narrowing to final candidates:\n\n```json\n{\n  \"name\": \"get_backtest\",\n  \"arguments\": { \"id\": 12345, \"includeTrades\": true, \"tradeLimit\": 20, \"includeEquityCurve\": true }\n}\n```\n\nBacktest and compare rows include `strategy.sourceAvailability` when known:\n\n- `available`: source text is available to this account. This does not prove the text is a complete standalone Pine strategy.\n- `no`: source code is not available for this strategy\n- `private`: source exists but this account cannot view it\n\nThe public repo also includes `docs/mcp-tools.md` with the same workflow.\n\n## Tool schemas\n\n### `search_symbols`\n\n```json\n{\n  \"query\": \"string\",\n  \"limit\": \"number, optional\"\n}\n```\n\n### `search_backtests`\n\nAllowed `sort` values: `sharpe`, `sharpeRatio`, `profitFactor`, `roi`, `netProfitPercent`, `latestTradeDate`, `robustness`.\n\n```json\n{\n  \"symbol\": \"string, optional\",\n  \"market\": \"crypto | stock | forex | futures, optional\",\n  \"timeframe\": \"string, optional\",\n  \"strategyType\": \"intraday | swing | longTerm, optional\",\n  \"minSharpe\": \"number, optional\",\n  \"minProfitFactor\": \"number, optional\",\n  \"maxDrawdown\": \"number, optional\",\n  \"sort\": \"sharpe | sharpeRatio | profitFactor | roi | netProfitPercent | latestTradeDate | robustness, optional\",\n  \"order\": \"desc | asc, optional\",\n  \"limit\": \"number, optional\"\n}\n```\n\n### `get_best_for_symbol`\n\n```json\n{\n  \"symbol\": \"string\",\n  \"limit\": \"number, optional\"\n}\n```\n\n### `get_backtest`\n\n```json\n{\n  \"id\": \"number\",\n  \"includeTrades\": \"boolean, optional\",\n  \"tradeLimit\": \"number, optional; default 20 when includeTrades is true\",\n  \"includeEquityCurve\": \"boolean, optional\"\n}\n```\n\n### `get_strategy`\n\n```json\n{\n  \"id\": \"number\",\n  \"includeSourceCode\": \"boolean, optional\"\n}\n```\n\nWhen `includeSourceCode` is true and source is available, the response includes `sourceCode`.\n\n### `compare_backtests`\n\n```json\n{\n  \"ids\": [\"number\"]\n}\n```\n\n### `get_account_status`\n\n```json\n{}\n```\n","readmeFilename":"README.md"}