Skip to main content

MCP server for querying Government Pension Fund Global (NBIM) data

Project description

NBIM MCP Server

MCP server for querying data from Norway's Government Pension Fund Global — the world's largest sovereign wealth fund.

What it does

Provides 6 tools for querying fund data through the Model Context Protocol:

Tool Description
nbim_fund_value Current fund value and asset allocation breakdown
nbim_holdings_search Search equity holdings by company, country, or sector
nbim_top_holdings Top N holdings by market value with filters
nbim_country_allocation Geographic allocation across 70+ countries
nbim_returns Annual and cumulative returns since 1998
nbim_exclusions Companies excluded or under observation

Install

pip install mcp-nbim

Or with uvx:

uvx mcp-nbim

Quick start

# Run with streamable HTTP (port 8008)
mcp-nbim

# Run with stdio (for Claude Desktop, Claude Code)
mcp-nbim --stdio

Claude Desktop

Add to claude_desktop_config.json:

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

Or if installed with pip:

{
  "mcpServers": {
    "nbim": {
      "command": "mcp-nbim",
      "args": ["--stdio"]
    }
  }
}

Claude Code

claude mcp add nbim -- uvx mcp-nbim --stdio

Docker

docker compose up

Example queries

  • "What is the fund worth today?" → nbim_fund_value()
  • "Top 10 holdings in Japan" → nbim_top_holdings(n=10, country='JP')
  • "Does the fund own Tesla?" → nbim_holdings_search(query='Tesla')
  • "How has the US allocation changed?" → compare nbim_country_allocation() across years
  • "Which companies are excluded for coal?" → nbim_exclusions(criterion='coal')
  • "Fund performance in 2008" → nbim_returns(start_year=2008, end_year=2008)

Data sources

Holdings data updates semi-annually and covers equities (~9,000 companies). Historical data goes back to 1998. No authentication required.

Related

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_nbim-0.1.0.tar.gz (14.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_nbim-0.1.0-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

Details for the file mcp_nbim-0.1.0.tar.gz.

File metadata

  • Download URL: mcp_nbim-0.1.0.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for mcp_nbim-0.1.0.tar.gz
Algorithm Hash digest
SHA256 72c39a99c74b2bbe1183e45b4372d5f32a19d004ff29eb573d70b7999e563b54
MD5 57210b697aaff9052e34b86b1358bb49
BLAKE2b-256 8b0df50d99a8fca3d1e4f00bab3d0d9ae3c2a32ec923d5080b41a7403de3baca

See more details on using hashes here.

File details

Details for the file mcp_nbim-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: mcp_nbim-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for mcp_nbim-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d0e99b1a7908df6dce40a806795ed232ba0f7e70285ebb4efedbd0b0e6f651d3
MD5 6cee4ff5ebd713a6e983abb87d786dde
BLAKE2b-256 084ec3e1725d5481720cf175ca6890b0f07565794ceac7d675b278c69dfbea7e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page