Skip to main content
Glama
nordnet-mcp

nordnet-mcp

by luimu64

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: yfinance-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:

Variable

Default

Purpose

NORDNET_BASE_URL

https://www.nordnet.fi

main site host (.se/.dk/.no also work)

NORDNET_MARKET_DATA_BASE_URL

https://api.prod.nntech.io

charts, indices, screening host

NORDNET_LOCALE

fi-FI

sent as x-locale on the 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

Tool

Returns

search(query, limit)

free-text search grouped by asset class

instrument(instrument_id)

full snapshot: identity, quote, returns, key ratios

quote(instrument_id)

latest price block with identity context

trades(instrument_id, count)

recent executed trades (the tape)

stocklist(limit, sort_attribute, sort_order, risers_only)

market overview (risers/fallers)

fund(instrument_id)

fund snapshot: NAV, fees, risk class, SFDR article

fund_profile(instrument_id) / fund_profile_by_slug(slug)

full fund screening profile

etf_profile(instrument_id) / etf_profile_by_slug(slug)

full ETF screening profile

stock_profile(instrument_id) / stock_profile_by_slug(slug)

full stock screening profile

chart(instrument_id, period) / chart_by_identifier(identifier, period)

price time series (8 periods)

news(instrument_id, limit, offset)

paginated news feed

indicators(list_id)

index/FX quotes for a market list

indicator(slug)

single indicator / FX quote (e.g. eurusd)

market_hours(instrument_id) / market_hours_for_order_book(order_book_id)

trading sessions; null when none

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

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.

Available Tools

19 tools
chartA

Price time series for an instrument (resolves the order book id automatically).

Periods: DAY_1, WEEK_1, MONTH_1, MONTH_3, MONTH_6, YTD, YEAR_1, ALL. Returns price points (open/high/low/last/volume), previous close and returns.

Inputs: instrument_id (required), period.

chart_by_identifierC

Price time series for a raw order book identifier (UUID from an instrument snapshot).

Inputs: identifier (required), period.

etf_profileB

Full ETF screening profile: fees, distribution type, holdings, sector/region exposures, sustainability, risk statistics.

Inputs: instrument_id (required).

etf_profile_by_slugA

Full ETF screening profile for a display slug (e.g. spdr-sp-500-ucits-spyl-xeta).

Inputs: slug (required).

fundB

Fund snapshot: NAV, fund metadata (yearly fee, risk group, SFDR article, dividend strategy, min investment).

Inputs: instrument_id (required).

fund_profileB

Full fund screening profile: NAV history, holdings, fund managers, fees, minimum investment, returns.

Inputs: instrument_id (required).

fund_profile_by_slugC

Full fund screening profile for a display slug (e.g. nordnet-one-rohkea-eur-c39cc36b).

Inputs: slug (required).

indicatorA

Single indicator/FX quote by display slug (e.g. eurusd, eursek, usdjpy, OMXHelsinki).

Inputs: slug (required).

indicatorsA

Index/FX quotes for a market list (e.g. FI_INDEX_GLOBAL, CURRENCY_GLOBAL), with sparkline data.

Inputs: list_id.

instrumentB

Full instrument snapshot: identity, quote, trading status, historical returns, key ratios, NNX metadata.

Inputs: instrument_id (required).

market_hoursB

Trading sessions and status for an instrument; null when the API has no hours for it.

Inputs: instrument_id (required). Returns: result

market_hours_for_order_bookA

Trading sessions and status for a raw order book UUID; null when the API has none.

Inputs: order_book_id (required). Returns: result

newsC

Paginated news feed for an instrument: headline, agency, type, published timestamp.

Inputs: instrument_id (required), limit, offset.

quoteA

Latest price block for an instrument, with identity context.

Includes last, bid/ask with resting volumes, open/close, high/low, spread, turnover, diff and diff_pct. Note: only top-of-book is public — the full order book depth ladder requires a login.

Inputs: instrument_id (required).

stocklistA

Market overview list of stocks (risers/fallers, most traded).

Default sorts by one-day change descending. Set risers_only=true to list only advancing stocks. Rows are lightweight snapshots plus company_info (report date, market cap).

Inputs: limit, sort_order, risers_only, sort_attribute.

stock_profileC

Full stock screening profile: company identity, market cap, key figures with fiscal-year history, earnings reports, dividends, news.

Inputs: instrument_id (required).

stock_profile_by_slugA

Full stock screening profile for a display slug (e.g. wartsila-b-wrt1v-xhel).

Inputs: slug (required).

tradesB

Recent executed trades (the trade tape) for an instrument: price, volume, type, timestamps.

Inputs: instrument_id (required), count.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 19 tools

    Disambiguation3/5

    Several tools have overlapping names or similar purposes: 'indicator' vs 'indicators' differ only in pluralization, and pairs like 'chart'/'chart_by_identifier' and 'market_hours'/'market_hours_for_order_book' are distinguished only by input format. Descriptions clarify the differences, but an agent could easily select the wrong tool without careful reading.

    Naming Consistency4/5

    Tool names follow a consistent snake_case noun pattern (e.g., instrument, quote, trades, stock_profile), with suffixes like _by_slug and _by_identifier used systematically. The naming is predictable, though the lack of verb prefixes and the close similarity between 'indicator' and 'indicators' slightly reduce consistency.

    Tool Count4/5

    With 19 tools, the server covers a broad range of market data needs—quotes, charts, news, profiles, market hours, and search—without becoming unwieldy. The count is on the higher end but well-justified for a comprehensive financial data server.

    Completeness5/5

    The tool surface is comprehensive, covering search, quotes, charts, news, trades, market hours, and detailed profiles for stocks, funds, and ETFs. Both slug and raw identifier variants ensure no dead ends for different input formats, and there are no obvious gaps in public market data coverage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides real-time quotes, historical OHLCV data, options chains, news, and multi-ticker comparisons to any MCP client via Yahoo Finance.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Local .NET MCP server for the Börsdata financial API. Provides stock prices, KPIs, financial reports, screening, insider transactions, short positions and more. Each user connects with their own Börsdata API key.
      1
      MIT