{
  "markdown": "# Quantustik MCP server — quantum-model S&P 500 analytics\n\n**[Quantustik](https://quantustik.com) is a risk-first market-intelligence\nlayer for humans and AI agents — calibrated probabilistic forecasts,\ntransparent track records, and machine-readable decision support through\nREST and MCP.** It forecasts S&P 500 price paths with a quantum-mechanics\nmodel (the\nSchrödinger equation and Feynman path integrals), layers a machine-learning\nclassifier and a market-conditions read on top, and turns the result into\n**risk-first BUY / WAIT / AVOID / EXIT signals** — each with entry price,\nstop-loss, take-profit ladder and position sizing, plus **calibrated 90%\nconfidence bands** and a **live, auditable track record that includes the\nlosses**.\n\n**What the analysis gives you, per ticker and for the whole index:**\n\n- a signal with the full trade plan behind it (only actionable at ≥2:1\n  reward-to-risk), and a two-sided explanation of *why* the model made\n  the call;\n- multi-horizon price forecasts (1mo / 3mo / 6mo / 1y) with measured,\n  published calibration — never a bare point estimate;\n- whole-universe scans (conviction / direction / sector filters), a\n  risk-vetted shortlist of asymmetric setups, market conditions and an\n  overheating gauge, backtests, fundamentals, dividends and more —\n  24 tools in total.\n\n**Who it is for:** AI agents and their users doing market research —\nanalysts, self-directed investors, and anyone who wants honest,\nuncertainty-explicit market context inside Claude, Cursor, ChatGPT or any\nother MCP client. Bullish calls are deliberately rare and earned: the model\nprefers saying WAIT to flattering you.\n\n> **Educational research only — not investment advice.** Nothing here is a\n> recommendation to buy or sell any security. Calibration is measured, not\n> guaranteed; past model performance does not predict future results.\n\n## What this package is\n\nA thin stdio proxy to Quantustik's hosted MCP server. It lets MCP clients\nthat only support local stdio servers (Claude Desktop, Cursor, Windsurf,\nand others) reach the live, keyless, streamable-HTTP endpoint at\n`https://quantustik.com/mcp`.\n\nThis package does not implement an MCP server itself, run any model\nlocally, or cache any data. It is a small wrapper around\n[`mcp-remote`](https://www.npmjs.com/package/mcp-remote) pointed at our\nhosted endpoint. Every tool call is forwarded live to `quantustik.com` and\nanswered from the same data and quota system as the hosted endpoint.\n\nIf your MCP client supports remote streamable-HTTP servers directly, you\ndon't need this package at all — just point it at `https://quantustik.com/mcp`.\nThis wrapper exists only for stdio-only clients.\n\nThe full tool catalog lives at\n[quantustik.com/developers](https://quantustik.com/developers).\n\n## Usage\n\n### Claude Desktop / Cursor / Windsurf\n\nAdd to your MCP client config (e.g. `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"quantustik\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@quantustik/mcp-server\"]\n    }\n  }\n}\n```\n\n### Command line\n\n```bash\nnpx -y @quantustik/mcp-server\n```\n\nThis starts a local stdio MCP server that proxies to\n`https://quantustik.com/mcp`. Anonymous use is allowed under a per-IP hourly\nquota; no setup required.\n\n### Optional: raise your quota with an API key\n\nGet a free key at [quantustik.com/developers](https://quantustik.com/developers),\nthen set it as an environment variable:\n\n```json\n{\n  \"mcpServers\": {\n    \"quantustik\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@quantustik/mcp-server\"],\n      \"env\": {\n        \"QUANTUSTIK_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Environment variables\n\n| Variable | Purpose | Default |\n|---|---|---|\n| `QUANTUSTIK_API_KEY` | Sent as `Authorization: Bearer <key>` to raise the anonymous per-IP hourly quota. | none (anonymous) |\n| `QUANTUSTIK_MCP_URL` | Override the remote endpoint (mainly for local development against a non-production instance). | `https://quantustik.com/mcp` |\n\nAny additional CLI arguments you pass are forwarded to the underlying\n`mcp-remote` proxy (e.g. `--debug`).\n\n## How it works\n\n`npx @quantustik/mcp-server` runs a small Node script\n(`bin/quantustik-mcp.js`) that spawns\n[`mcp-remote`](https://www.npmjs.com/package/mcp-remote) against\n`https://quantustik.com/mcp` using the `http-only` transport (our endpoint\nis streamable-HTTP, not SSE). `mcp-remote` speaks stdio to your MCP client\non one side and streamable-HTTP to our server on the other — this package\njust pins the URL, transport, and optional auth header so you don't have to\nremember them.\n\n## Source\n\nServer implementation (Python, FastMCP): the hosted endpoint's source lives\nin [mcplafed/autoevolve](https://github.com/mcplafed/autoevolve)\n(`app/mcp_server.py`, `server.json`). This wrapper repo only contains the\nthin npm client shown above.\n\n## Disclaimer\n\nAll signals, forecasts, and market data returned by the Quantustik MCP\nserver are for educational and research purposes only and do not\nconstitute personalized financial advice. Past model performance does not\nguarantee future results. Always consult a qualified financial professional\nbefore making investment decisions.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 5212,
  "sha": "a46e954a9beb054672d4bdc492784c6d66b86839d349e0cb9b993f3d78d9773d",
  "repo_slug": "quantustik/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_quantustik_mcp_d2a15334/readme"
}