@quantustik/mcp-server

A thin stdio proxy to Quantustik's hosted MCP server. It lets MCP clients that only support local stdio servers (Claude Desktop, Cursor, Windsurf, and others) reach our live, keyless, streamable-HTTP endpoint at https://quantustik.com/mcp.

This package does not implement an MCP server itself, run any model locally, or cache any data. It is a small wrapper around mcp-remote pointed at our hosted endpoint. Every tool call is forwarded live to quantustik.com and answered from the same data and quota system as the hosted endpoint.

If your MCP client supports remote streamable-HTTP servers directly, you don't need this package at all — just point it at https://quantustik.com/mcp. This wrapper exists only for stdio-only clients.

What you get

Live S&P 500 signals, forecasts, trade plans, market-regime data, and more — powered by Quantustik's quantum-mechanics-based forecasting model (Schrödinger equation + Feynman path integrals). See the full tool list at quantustik.com/developers.

Educational and research purposes only — not personalized financial advice.

Usage

Claude Desktop / Cursor / Windsurf

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "quantustik": {
      "command": "npx",
      "args": ["-y", "@quantustik/mcp-server"]
    }
  }
}

Command line

npx -y @quantustik/mcp-server

This starts a local stdio MCP server that proxies to https://quantustik.com/mcp. Anonymous use is allowed under a per-IP hourly quota; no setup required.

Optional: raise your quota with an API key

Get a free key at quantustik.com/developers, then set it as an environment variable:

{
  "mcpServers": {
    "quantustik": {
      "command": "npx",
      "args": ["-y", "@quantustik/mcp-server"],
      "env": {
        "QUANTUSTIK_API_KEY": "your-key-here"
      }
    }
  }
}

Environment variables

Variable	Purpose	Default
QUANTUSTIK_API_KEY	Sent as Authorization: Bearer <key> to raise the anonymous per-IP hourly quota.	none (anonymous)
QUANTUSTIK_MCP_URL	Override the remote endpoint (mainly for local development against a non-production instance).	https://quantustik.com/mcp

Any additional CLI arguments you pass are forwarded to the underlying mcp-remote proxy (e.g. --debug).

How it works

npx @quantustik/mcp-server runs a small Node script (bin/quantustik-mcp.js) that spawns mcp-remote against https://quantustik.com/mcp using the http-only transport (our endpoint is streamable-HTTP, not SSE). mcp-remote speaks stdio to your MCP client on one side and streamable-HTTP to our server on the other — this package just pins the URL, transport, and optional auth header so you don't have to remember them.

Source

Server implementation (Python, FastMCP): the hosted endpoint's source lives in mcplafed/autoevolve (app/mcp_server.py, server.json). This wrapper repo only contains the thin npm client shown above.

Disclaimer

All signals, forecasts, and market data returned by the Quantustik MCP server are for educational and research purposes only and do not constitute personalized financial advice. Past model performance does not guarantee future results. Always consult a qualified financial professional before making investment decisions.

License

MIT — see LICENSE.