Skip to content
noxstock
MCP

MCP overview

Use noxstock through read-only MCP tools.

noxstock MCP is a read-only wrapper around the REST API.

  • Source of truth: REST.
  • Transport: stdio locally; Streamable HTTP is available as an explicit local transport.
  • Auth: MCP sends X-API-Key to REST using NOXSTOCK_API_KEY.
  • Output: successful tool calls return the REST JSON envelope unchanged.

MCP does not call providers directly, perform extra calculations, or reshape schemas. If you need exact contracts, use REST/OpenAPI as source of truth.

Required env

export NOXSTOCK_API_BASE_URL="https://api.noxstock.com"
export NOXSTOCK_API_KEY="nxs_your_api_key"

Local stdio command

python -m noxstock.mcp.server --stdio

Local Streamable HTTP command

uv run python -m noxstock.mcp.server --streamable-http --host 127.0.0.1 --port 8001

The Streamable HTTP server listens at /mcp.

Access rules

MCP tools use the same REST plan access:

  • Free: noxstock_search, noxstock_coverage, noxstock_snapshot, noxstock_valuation
  • Starter/Builder: all tools