Skip to main content
Glama
nip-checker-mcp

nip-checker-mcp

by solverio-pl

Polish NIP Checker MCP Server

A Model Context Protocol (MCP) server for checking Polish NIP (Tax Identification Numbers) using the official Ministry of Finance VAT taxpayer database.

Features

  • ✅ Real-time NIP verification using official Polish Ministry of Finance API

  • ✅ Bank account verification - check if bank account belongs to specific NIP

  • ✅ Automatic date handling - defaults to current date

  • ✅ Input normalization - handles NIP formats with or without hyphens

  • ✅ Comprehensive error handling and validation

  • ✅ Ready for Claude Desktop - works seamlessly with AI assistants

Related MCP server: mcp-wl-vat

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "nip-checker": {
      "command": "npx",
      "args": ["-y", "@solverio-pl/nip-checker-mcp@latest"]
    }
  }
}

Installation Options

Option 1: Direct npx usage (No installation needed)

npx @solverio-pl/nip-checker-mcp@latest

Option 2: Global installation

npm install -g @solverio-pl/nip-checker-mcp
nip-checker-mcp

Option 3: Local development

git clone https://github.com/solverio-pl/nip-checker-mcp.git
cd nip-checker-mcp
npm install
npm run build
npm start

Available Tools

check_nip

Verify Polish NIP in the VAT taxpayer database.

Parameters:

  • nip (required): Polish NIP number (10 digits, hyphens optional)

  • date (optional): Date for verification (YYYY-MM-DD format, defaults to today)

Example:

Check NIP 9491626103

check_nip_bank_account

Verify if a bank account is assigned to a specific NIP.

Parameters:

  • nip (required): Polish NIP number (10 digits)

  • bankAccount (required): Bank account number (26 digits)

  • date (optional): Date for verification (YYYY-MM-DD format)

Example:

Verify if account 38109017950000000151316514 belongs to NIP 9491626103

Sample Output

✅ NIP Verification Results

**NIP**: 9491626103
**Company**: JANUSZ CHALIMONIUK
**VAT Status**: Czynny (Active)
**Address**: BURSZTYNOWA 73D, 42-202 CZĘSTOCHOWA
**Registration Date**: 2022-09-01
**Bank Accounts**: 38109017950000000151316514
**REGON**: 240070517
**Virtual Accounts**: No

**Request Details**:
- Request ID: rLtV8-9471ak2
- Query Date: 02-08-2025 09:29:38

Claude Desktop Configuration

Windows

Edit: %APPDATA%\Claude\claude_desktop_config.json

macOS

Edit: ~/Library/Application Support/Claude/claude_desktop_config.json

Full configuration example:

{
  "mcpServers": {
    "nip-checker": {
      "command": "npx",
      "args": ["-y", "@solverio-pl/nip-checker-mcp@latest"]
    }
  }
}

Personal Settings Addition

Add this simple line to your Claude personal settings for automatic usage:

NIP Checker: When user asks to check/verify/lookup a Polish NIP number, use the check_nip MCP tool automatically.

Usage Examples

Once configured, you can simply ask:

  • "check nip 9491626103"

  • "verify nip 123-456-78-90"

  • "lookup nip 9491626103 for yesterday"

  • "is account 38109017950000000151316514 assigned to nip 9491626103?"

API Source

This tool uses the official Polish Ministry of Finance API:

  • Base URL: https://wl-api.mf.gov.pl/

  • Documentation: Available at the API endpoint

  • Data Source: Official VAT taxpayer registry ("Biała Lista Podatników")

Requirements

  • Node.js 18.0.0 or higher

  • Internet connection for API access

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues and feature requests, please use the GitHub Issues page.


Made with ❤️ by Solverio for the Polish business community.

Available Tools

2 tools
check_nipB

Check Polish NIP (Tax Identification Number) in the Ministry of Finance VAT taxpayer database

Inputs: nip (required), date.

check_nip_bank_accountA

Verify if a bank account is assigned to a specific NIP

Inputs: nip (required), bankAccount (required), date.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one checks the NIP itself against the VAT database, the other verifies a bank account against a NIP. There is no overlap or ambiguity in their functions.

    Naming Consistency5/5

    Both tool names follow the same verb_noun pattern: check_nip and check_nip_bank_account. The pattern is predictably extended with a qualifier, maintaining consistency.

    Tool Count4/5

    With only 2 tools, the server is minimal but well-scoped for its narrow purpose (NIP validation). It falls slightly below the typical 3-15 range, but the focus on two core operations makes the count appropriate.

    Completeness5/5

    The server covers the two essential operations for its domain: validating a NIP and verifying a bank account association. No obvious gaps exist for the stated purpose of a NIP checker.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for querying the Polish VAT taxpayer white list via the official Ministry of Finance API. Enables search by NIP, REGON, or bank account, and verification of NIP-bank account pairs, with built-in daily limit protection.
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables looking up Polish companies by NIP, REGON, or KRS number to retrieve their registered name, legal address, and entity type from Statistics Poland's official register.
      78 npm
      MIT