nip-checker-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nip-checker-mcp check nip 9491626103"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Quick Start with npx (Recommended)
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@latestOption 2: Global installation
npm install -g @solverio-pl/nip-checker-mcp
nip-checker-mcpOption 3: Local development
git clone https://github.com/solverio-pl/nip-checker-mcp.git
cd nip-checker-mcp
npm install
npm run build
npm startAvailable 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 9491626103check_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 9491626103Sample 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:38Claude 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 toolscheck_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
Scored across 2 tools
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.
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.
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.
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
Verify Polish companies by NIP/KRS/REGON + EU VAT (VIES). 14 MCP tools (9 no-key).
Verify Polish companies: VAT white list (MF), KRS, VIES, payment audit PDF, monitoring.
Czech company and VAT checks, EU VAT validation, IBAN checksums and Czech National Bank rates.
Polish companies and people: KRS, CEIDG, financials, boards, VAT, sanctions. Free, no API key.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides AI agents with real-time access to Polish official data: VAT whitelist for company verification and NBP exchange rates, enabling checks on VAT status, company details, and currency conversion without API keys.5MIT
- AlicenseAqualityDmaintenanceMCP 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.4MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to verify Polish companies and EU VAT numbers against official government registries using 9 tools, with no API key and optional plain REST access.MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT