English Français العربية

io.github.p-meier/northdata-mcp

Official registry Other

NorthData API for German company, owner, and financial data — with a built-in credit guard.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package northdata-mcp
Claude Code 
claude mcp add northdata-mcp -e 'NORTHDATA_API_KEY=<your northdata_api_key>' -e 'NORTHDATA_APPROVAL_THRESHOLD=<NORTHDATA_APPROVAL_THRESHOLD>' -e 'NORTHDATA_ABSOLUTE_MAX=<NORTHDATA_ABSOLUTE_MAX>' -e 'NORTHDATA_CREDIT_LOG=<NORTHDATA_CREDIT_LOG>' -- uvx northdata-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "northdata-mcp": {
            "command": "uvx",
            "args": [
                "northdata-mcp==0.1.1"
            ],
            "env": {
                "NORTHDATA_API_KEY": "<your northdata_api_key>",
                "NORTHDATA_APPROVAL_THRESHOLD": "<NORTHDATA_APPROVAL_THRESHOLD>",
                "NORTHDATA_ABSOLUTE_MAX": "<NORTHDATA_ABSOLUTE_MAX>",
                "NORTHDATA_CREDIT_LOG": "<NORTHDATA_CREDIT_LOG>"
            }
        }
    }
}

Environment variables

  • NORTHDATA_API_KEY required secret Your NorthData API key. Obtain one at https://www.northdata.com
  • NORTHDATA_APPROVAL_THRESHOLD Power-search 'limit' above this requires approve_high_cost=true. Default: 25.
  • NORTHDATA_ABSOLUTE_MAX Hard ceiling for power-search 'limit'. Default: 100. Flag-immune.
  • NORTHDATA_CREDIT_LOG Path to the local credit log file. Default: ~/.northdata/credits.jsonl

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. NorthData Connectors
  2. Why this exists
  3. Quick start
  4. Architecture
  5. Development
  6. License
  7. Links

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:

PackageWhat it isInstall
northdata-cliCommand-line client. JSON-by-default, table with --pretty. Single source of API logic.pipx install northdata-cli
northdata-mcpModel Context Protocol server exposing every CLI command as a tool. Works with Claude Desktop, Claude Code, Cursor, etc.pipx install northdata-mcp
skills/northdataClaude Skill with usage guidance, credit-guard discipline, and endpoint cheat-sheet.npx skills add p-meier/northdata-connectors

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 https://www.northdata.com. Set it as NORTHDATA_API_KEY.

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-connectors
3. Credit-safe by default

Every billable call respects two tiers:

TierDefaultEnv var
Approval threshold25NORTHDATA_APPROVAL_THRESHOLD
Absolute maximum100NORTHDATA_ABSOLUTE_MAX

Use --dry-run (CLI) or dry_run=true (MCP) to inspect a request without spending credits.

Architecture

                      ┌─────────────────────────────────────────┐
                      │         NorthData API (HTTP)            │
                      └─────────────────────────────────────────┘
                                        ▲
                                        │ httpx + Credit Guard
                                        │
                            ┌───────────────────────┐
                            │   northdata-cli       │  ← single source of API logic
                            │   (Python library)    │     (client, credit guard,
                            └───────────────────────┘      config, output)
                                ▲               ▲
                    imports     │               │  invokes
                                │               │
              ┌───────────────────────┐   ┌───────────────────────┐
              │   northdata-mcp       │   │   shell / CI /        │
              │   (FastMCP, stdio)    │   │   scripts             │
              └───────────────────────┘   └───────────────────────┘
                        ▲
                        │ MCP over stdio
                        │
              ┌───────────────────────┐
              │   Claude / Cursor /   │   ← with skills/northdata/SKILL.md
              │   any MCP client      │     loaded for usage guidance
              └───────────────────────┘

The CLI holds the API logic; the MCP server is a thin wrapper; the Skill is documentation-as-code. All three share one credit guard.

Development

git clone https://github.com/p-meier/northdata-connectors.git
cd northdata-connectors

# CLI
cd northdata-cli && python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]" && pytest

# MCP
cd ../northdata-mcp && python -m venv .venv && source .venv/bin/activate
pip install -e "../northdata-cli" -e ".[dev]" && pytest

License

MIT. See LICENSE.

Frequently asked questions

What is io.github.p-meier/northdata-mcp?

NorthData API for German company, owner, and financial data — with a built-in credit guard.

How do I install io.github.p-meier/northdata-mcp?

It runs on your machine. In Claude Code: claude mcp add northdata-mcp -e 'NORTHDATA_API_KEY=<your northdata_api_key>' -e 'NORTHDATA_APPROVAL_THRESHOLD=<NORTHDATA_APPROVAL_THRESHOLD>' -e 'NORTHDATA_ABSOLUTE_MAX=<NORTHDATA_ABSOLUTE_MAX>' -e 'NORTHDATA_CREDIT_LOG=<NORTHDATA_CREDIT_LOG>' -- uvx northdata-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.p-meier/northdata-mcp need an API key?

Yes. It expects NORTHDATA_API_KEY, which you set in its configuration.

Is io.github.p-meier/northdata-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.p-meier/northdata-mcp?

It is published by p-meier. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.