nordnet-mcp

A Model Context Protocol server exposing Nordnet's public market data — quotes, charts, news, trade tape, fund/ETF/ stock profiles and FX rates — via the nordnet-sdk.

No account. No API key. No login. This talks to the same API Nordnet's website uses for anonymous visitors, so it runs anywhere, needs zero configuration, and holds no secrets.

Install

pip install nordnet-mcp
# or with pipx for an isolated runtime:
pipx install nordnet-mcp

Requires Python 3.10+.

Related MCP server: polygon-mcp

Run

nordnet-mcp            # console script
python -m nordnet_mcp  # or module form

The server speaks MCP over stdio — wire it into any MCP client.

Configuration

Configuration is read from environment variables; defaults target Nordnet's Finnish site and the public market-data host:

Client wiring

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "nordnet": {
      "command": "nordnet-mcp"
    }
  }
}

Hermes Agent (~/.hermes/config.yaml):

mcp_servers:
  nordnet:
    command: /path/to/nordnet-mcp

Generic stdio MCP client:

{ "mcpServers": { "nordnet": { "command": "uvx", "args": ["nordnet-mcp"] } } }

Tools

Chart periods: DAY_1, WEEK_1, MONTH_1, MONTH_3, MONTH_6, YTD, YEAR_1, ALL.

Instrument IDs are Nordnet's internal numeric IDs (e.g. 16100884 = Wärtsilä B, 17794251 = Nordnet One Rohkea EUR). Find them with search, or read them from instrument pages on nordnet.fi.

Public data boundary

Everything served here is data Nordnet shows to anonymous visitors. The one notable exception: full order book depth (the multi-level bid/ask ladder) is login-only — anonymously you only get top-of-book (best bid/ask with resting volumes). This server respects that boundary by design.

Development

pip install -e ".[dev]"
pytest           # offline — runs against a local fixture server
uv build         # wheel + sdist

Legal

Unofficial, not affiliated with or endorsed by Nordnet. Only reads public data; please be polite to the API (the SDK retries transient failures with backoff). Use at your own risk; market data may be delayed. MIT licensed.