Northdata MCP server
io.github.p-meier/northdata-mcp·v0.1.1·4 starsNorthData API for German company, owner, and financial data — with a built-in credit guard.
4 stars16 downloads/wk
Reviews
Write oneNobody has reviewed Northdata yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Northdata tools (9)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
billingFree endpoint. Remote credit usage for the billing period.
companyBilled (1 credit). Full company profile.
local_credit_logReturn the local credit log written by this server (best-effort).
personBilled (1 credit). Person details incl. birth date / roles.
publicationsBilled. Publications lookup (e.g. shareholder lists).
reference_overviewFree endpoint. API reference overview (standards, countries, ...).
reference_segment_codesFree endpoint. Segment codes for a given standard.
searchBilled. Power search. Cost = up to ``limit`` credits.
suggestFree endpoint. Autocomplete suggestions for companies or persons.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 162 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Northdata compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,255 servers
- Tools
- 9
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 4
- more than 82% of 28,688 servers
- Downloads a week
- 16
- more than 4% of 12,191 servers with a package
What its tools let an agent do: 9 read
Install Northdata in Claude Code, Cursor or VS Code
claude mcp add northdata-mcp -- uvx northdata-mcp
What the publisher says
From the Northdata repository's README, as published. We do not edit it. Read it on GitHub
NorthData Connectors
Generic, product-side wrapper around the NorthData API — a Python CLI, an MCP server, and a Claude Skill, sharing one credit guard.
Unofficial project. This repository is an independent, community-maintained wrapper around the NorthData API. It is not developed, endorsed, or supported by NorthData GmbH. "NorthData" is a trademark of its respective owner; all company data accessed through this tooling remains subject to NorthData's own terms of service. For the official API documentation, see github.com/northdata/api.
This monorepo ships three layers on top of the NorthData API:
All three share one credit guard because NorthData charges per returned company, not per HTTP call.
Why this exists
NorthData's API is the canonical source for German commercial-register data (company profiles, owners, representatives, financials, publications). This repo makes it trivial to consume that data from:
- Shell scripts and CI pipelines (northdata search ...)
- AI agents in any MCP-capable client (Claude Desktop, Cursor, Claude Code, …)
- Claude Skills that want domain-aware guidance without duplicating API code
The three layers never duplicate logic — the CLI is the library, the MCP server imports it, the Skill references the MCP tools.
Quick start
1. Get a NorthData API key
At . Set it as NORTHDATAAPIKEY.
2. Install what you need
# Shell usage
pipx install northdata-cli
export NORTHDATA_API_KEY=XXXX-XXXX
northdata suggest "Siemens" --pretty
# MCP server for Claude Desktop / Cursor / Claude Code
pipx install northdata-mcp
# then add the stdio server to your MCP client config
# (see northdata-mcp/README.md)
# Claude Skill — usage guidance for agents
npx skills add p-meier/northdata-connectors3. Credit-safe by default
Every billable call respects two tiers:
Use --dry-run (CLI) or dry_run=true (MCP) to inspect a request without spending credits.
Architecture
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Northdata: common questions
- Is Northdata MCP server safe?
- Mostly: it is graded B (72/100). Read the Northdata safety report
- How do I install Northdata?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Northdata need an API key?
- Yes. The registry entry asks for
NORTHDATA_API_KEY. - Is Northdata maintained?
- The last commit was 200 days ago (2026-04-18). The latest release is v0.1.1.
- How does Northdata compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.