{"_id":"@agent-signal/mcp","_rev":"4-4489d5e7d3fea4a0398f2abe5a48c41b","name":"@agent-signal/mcp","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"@agent-signal/mcp","version":"1.0.0","keywords":["mcp","trading","signals","ai-agent","agentsignal","x402","compass","radar","crypto"],"author":{"name":"AgentSignal"},"license":"MIT","_id":"@agent-signal/mcp@1.0.0","maintainers":[{"name":"agentsignal","email":"toknwrks@proton.me"}],"homepage":"https://agentsignal.app/ai-trading-plugin","bugs":{"url":"https://github.com/ToknWrks/agentsignal/issues"},"bin":{"agentsignal-mcp":"dist/index.js"},"dist":{"shasum":"879495c3ee00426a92b9012c6bc8bc268b154720","tarball":"https://registry.npmjs.org/@agent-signal/mcp/-/mcp-1.0.0.tgz","fileCount":5,"integrity":"sha512-rDe1+fsFM2L9Ct8pjfmUXXuizatiG/SyK+K6D4Tu2g7oeMKOMIMNijjL2Ic6bHjw8btq07+iRrWOesFGfbFg8Q==","signatures":[{"sig":"MEQCIHAIQAeZcDj4RoA+QRwK54bPP5g6yolFYj+cueWZ95/yAiB9njK3g2lef0CpnSDcG+NZdBOGa/m6DEze3u13NkRoqA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19050},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"261a82d5fc688ecb452625435685a679e9d653d1","scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"agentsignal","email":"toknwrks@proton.me"},"repository":{"url":"git+https://github.com/ToknWrks/agentsignal.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.6.2","description":"MCP server for AgentSignal — live LONG/FLAT/SHORT trading signals for AI agents","directories":{},"_nodeVersion":"25.1.0","dependencies":{"zod":"^3.22.0","viem":"^2.0.0","@x402/evm":"^2.9.0","@x402/core":"^2.9.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1775402753071_0.4315917509182432","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@agent-signal/mcp","version":"1.1.0","keywords":["mcp","trading","signals","ai-agent","agentsignal","x402","compass","radar","crypto"],"author":{"name":"AgentSignal"},"license":"MIT","_id":"@agent-signal/mcp@1.1.0","maintainers":[{"name":"agentsignal","email":"toknwrks@proton.me"}],"homepage":"https://agentsignal.app/ai-trading-plugin","bugs":{"url":"https://github.com/ToknWrks/agentsignal/issues"},"bin":{"agentsignal-mcp":"dist/index.js"},"dist":{"shasum":"1ca305eb0b381e68c3c60c9773572112d7646a43","tarball":"https://registry.npmjs.org/@agent-signal/mcp/-/mcp-1.1.0.tgz","fileCount":5,"integrity":"sha512-3rSRJo0zOw2+hD2hPgQYbPwVahogzr0JslIxzuHZrQW/VuzQZ8yBnTHjujkRv8Dx8ro7NiYnqbmchUxacrwjmA==","signatures":[{"sig":"MEQCICZeK7LV6ZORY01bo5ZfTOmFEEDsYp98Blsq00dqptH2AiByj63JERZW5OgzJBiI16O6zeCtZ0L9kV1XbY1o+IrX7A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34733},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"23f5f2f034f95fa337f84524c42a4e7395d3aa4e","scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"agentsignal","email":"toknwrks@proton.me"},"repository":{"url":"git+https://github.com/ToknWrks/agentsignal.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.6.2","description":"MCP server for AgentSignal — live LONG/FLAT/SHORT trading signals for AI agents","directories":{},"_nodeVersion":"25.1.0","dependencies":{"zod":"^3.22.0","viem":"^2.0.0","@x402/evm":"^2.9.0","@x402/core":"^2.9.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.0_1776170982258_0.8780764459202068","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@agent-signal/mcp","version":"1.2.0","keywords":["mcp","trading","signals","ai-agent","agentsignal","x402","compass","radar","crypto"],"author":{"name":"AgentSignal"},"license":"MIT","_id":"@agent-signal/mcp@1.2.0","maintainers":[{"name":"agentsignal","email":"toknwrks@proton.me"}],"homepage":"https://agentsignal.app/ai-trading-plugin","bugs":{"url":"https://github.com/ToknWrks/agentsignal/issues"},"bin":{"agentsignal-mcp":"dist/index.js"},"dist":{"shasum":"db0f81d94b8d666df38da5a5bbc7c0f88f85a799","tarball":"https://registry.npmjs.org/@agent-signal/mcp/-/mcp-1.2.0.tgz","fileCount":5,"integrity":"sha512-Djo+vMM+m0kqH8JCgbjEJU+eUhZ9/WO2Y5DOr8Hni/ewxCPSmq8EN89H3nuoEdhm4B3s33AHmM4uBTJCn4C9XA==","signatures":[{"sig":"MEQCIA1GyTcSxgdGgG0ctjGWpONkZbg+563d0lfdBFLSt8uqAiBngA3rUl/YJCigxklDMTxFruPQj5F0AVn9GO3n+DBF7A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35423},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"ef0dcfd9e818c26ed5b37d860f126f8b4a1906c6","scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"agentsignal","email":"toknwrks@proton.me"},"repository":{"url":"git+https://github.com/ToknWrks/agentsignal.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.6.2","description":"MCP server for AgentSignal — live LONG/FLAT/SHORT trading signals for AI agents","directories":{},"_nodeVersion":"25.1.0","dependencies":{"zod":"^3.22.0","viem":"^2.0.0","@x402/evm":"^2.9.0","@x402/core":"^2.9.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.2.0_1776181050842_0.21683986285065737","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@agent-signal/mcp","version":"1.3.0","description":"MCP server for AgentSignal — live LONG/FLAT/SHORT trading signals for AI agents","type":"module","main":"dist/index.js","bin":{"agentsignal-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"node --loader ts-node/esm src/index.ts","prepublishOnly":"npm run build"},"keywords":["mcp","trading","signals","ai-agent","agentsignal","x402","compass","radar","crypto"],"author":{"name":"AgentSignal"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","@x402/core":"^2.9.0","@x402/evm":"^2.9.0","viem":"^2.0.0","zod":"^3.22.0"},"devDependencies":{"typescript":"^5.0.0","@types/node":"^20.0.0"},"engines":{"node":">=18"},"repository":{"type":"git","url":"git+https://github.com/ToknWrks/agentsignal.git","directory":"packages/mcp"},"homepage":"https://agentsignal.app/ai-trading-plugin","_id":"@agent-signal/mcp@1.3.0","gitHead":"9e75507291be32e3ba50c108a4c5882f7d3b8c4f","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/ToknWrks/agentsignal/issues"},"_nodeVersion":"22.23.0","_npmVersion":"10.9.8","dist":{"integrity":"sha512-yYCCR/rsMwuSU0FvLXz0pV+MNYml0VnWR+U4eAV60Tx30kRjDc7/5Rce2LfmRgKSUctPLBip642Q3O9WOOST2Q==","shasum":"7eef7835405092f7363729463518c213b37707aa","tarball":"https://registry.npmjs.org/@agent-signal/mcp/-/mcp-1.3.0.tgz","fileCount":6,"unpackedSize":28551,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHmQZA3JrKufm6oZj+zNKgncUpxUFTc//Xqjj6cA60FwAiEAlEmL3RGV0/jLqpZIeXzS+pzG7Hq4bhGKMrPuxoY7Jdw="}]},"_npmUser":{"name":"agentsignal","email":"toknwrks@proton.me"},"directories":{},"maintainers":[{"name":"agentsignal","email":"toknwrks@proton.me"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.3.0_1786034403829_0.8749132171353318"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-05T15:25:52.982Z","modified":"2026-08-06T16:40:04.162Z","1.0.0":"2026-04-05T15:25:53.232Z","1.1.0":"2026-04-14T12:49:42.417Z","1.2.0":"2026-04-14T15:37:30.962Z","1.3.0":"2026-08-06T16:40:03.972Z"},"bugs":{"url":"https://github.com/ToknWrks/agentsignal/issues"},"author":{"name":"AgentSignal"},"license":"MIT","homepage":"https://agentsignal.app/ai-trading-plugin","keywords":["mcp","trading","signals","ai-agent","agentsignal","x402","compass","radar","crypto"],"repository":{"type":"git","url":"git+https://github.com/ToknWrks/agentsignal.git","directory":"packages/mcp"},"description":"MCP server for AgentSignal — live LONG/FLAT/SHORT trading signals for AI agents","maintainers":[{"name":"agentsignal","email":"toknwrks@proton.me"}],"readme":"# @agent-signal/mcp\n\nMCP server for [AgentSignal](https://agentsignal.app) — live LONG/FLAT/SHORT trading signals, COMPASS macro score, RADAR calendar risk, and backtests for AI agents. Paid tools settle automatically via [x402](https://github.com/coinbase/x402) micropayments in USDC on Base — no API key, no subscription.\n\nSource: [github.com/ToknWrks/agentsignal](https://github.com/ToknWrks/agentsignal/tree/main/packages/mcp) (this package lives at `packages/mcp` in the AgentSignal monorepo). For the standalone desktop app that executes trades against an exchange, see [github.com/ToknWrks/trader](https://github.com/ToknWrks/trader) — a separate project.\n\n## Install\n\n```bash\nclaude mcp add agentsignal \\\n  --command npx \\\n  --args \"-y @agent-signal/mcp@latest\"\n```\n\nOr add it directly to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentsignal\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agent-signal/mcp@latest\"],\n      \"env\": {\n        \"AGENT_PRIVATE_KEY\": \"0x...\"\n      }\n    }\n  }\n}\n```\n\n## Environment variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `AGENT_PRIVATE_KEY` | Only for paid tools | 0x-prefixed EVM private key, funded with USDC on Base. Used to sign x402 payments locally — never sent to AgentSignal. Free tools (`list_strategies`, `get_compass`, `get_radar`, `get_crypto_radar`, `get_signal_history`, `get_latest_report`) work without it. |\n| `AGENTSIGNAL_URL` | No | Override the API base URL. Defaults to `https://agentsignal.app`. |\n\nWithout `AGENT_PRIVATE_KEY`, calling a paid tool returns an HTTP 402 error from AgentSignal rather than failing locally — you'll see the price in the error message.\n\n## Tools\n\n| Tool | Cost | Description |\n|---|---|---|\n| `get_signal` | $0.01 via x402 | Live LONG/FLAT/SHORT signal for a saved strategy — direction, price, COMPASS score, per-condition results. |\n| `run_backtest` | $0.05 via x402 | Full historical backtest — return, alpha, Sharpe, Sortino, max drawdown, win rate, trade log. |\n| `list_strategies` | Free | List public template strategies. |\n| `get_compass` | Free | Latest COMPASS macro risk-on/off score (-7 to +7). |\n| `get_radar` | Free | Latest RADAR calendar risk score (FOMC/CPI proximity). |\n| `get_crypto_radar` | Free | AI-generated crypto market risk assessment. |\n| `get_signal_history` | Free | Last 30 days of stored signals for a strategy. |\n| `get_latest_report` | Free | Today's full market analyst report. |\n| `get_premium_fade_signals` | $0.10 via x402 | Premium fade options signals for a ticker. |\n| `update_premium_fade_pos` | Free | Close/update a premium fade position. |\n\nFull parameter schemas are exposed via MCP `tools/list` — any MCP client will show them directly.\n\n## How x402 payment works here\n\n1. A paid tool call hits an AgentSignal endpoint that requires payment.\n2. This server catches the HTTP 402 response, signs an EIP-3009 USDC authorization with `AGENT_PRIVATE_KEY` via `viem`, and retries the request using `@x402/core` + `@x402/evm`.\n3. Coinbase's CDP facilitator settles the transfer on Base mainnet (`eip155:8453`). The tool call returns once payment clears — typically 1–3 seconds.\n\nYour agent's model never sees or reasons about the private key or the payment flow — it just calls a tool and gets data back.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}