MCP NIF.PT

MCP NIF.PT is an MCP server that connects LLM clients to the Portuguese NIF.PT public API to retrieve and analyze corporate registry information across Portugal. Developed with FastMCP and Python, it allows business analysts, compliance officers, developers, and researchers to query live business records directly inside conversational AI environments. The server enables users to look up comprehensive company details using a Portuguese tax identification number (NIF), perform searches by company name or municipality, and confirm corporate registration numbers from exact business titles. In addition to basic identification, the integration provides operational details such as company status (active or closed), primary economic activity codes (CAE), registered business addresses paired with Google Maps links, and direct contact details including phone numbers, email addresses, and corporate websites. It also offers specialized classification functions, such as identifying accounting-related businesses and returning references to regional business directories like Racius and Portugalio. By exposing these tools via standard input and output transport, the server simplifies verification processes, due diligence, and local market research without requiring manual navigation of external business portals.

Category: CRM, ERP & E-commerce

Tags: business, company-data, corporate-registry, nif, portugal

Visit MCP NIF.PT

How to install and configure MCP NIF.PT

1. Clone the project repository from https://github.com/ruicarvalho1/MCP_Nif and set up your Python environment: bash python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt 2. Open Claude Desktop, navigate to Settings > Developer, and select Edit Configuration to open claude_desktop_config.json. 3. Add the server entry under mcpServers: json { "mcpServers": { "nif-pt-server": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER", "run", "main.py" ] } } } Replace /ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER with the local directory where main.py is saved. 4. Alternatively, install the server directly into Claude Desktop via the Smithery CLI: bash npx -y @smithery/cli@latest install @ruicarvalho1/mcp_nif --client claude 5. Restart Claude Desktop to activate the server.

What you can do with MCP NIF.PT

• Verify whether a Portuguese business entity is currently active or formally closed using its tax identification number. - Search for registered Portuguese companies operating within a specific city or municipality using corporate name keywords. - Retrieve corporate contact details, registered street addresses, Economic Activity Codes (CAE), and Google Maps locations for invoicing verification. - Identify whether a specific Portuguese organization provides accounting and financial services based on registered business activities. - Look up the official Portuguese tax identification number of an organization given its exact legal entity name.

Key facts

• https://github.com/ruicarvalho1/MCP_Nif
• CRM, ERP & E-commerce, Web Search & Research
• business, company-data, corporate-registry, nif, portugal

Part of MCP Servers

How do I install MCP NIF.PT?

You can install MCP NIF.PT locally by setting up a Python virtual environment and installing dependencies from requirements.txt, then configuring Claude Desktop with the uv runner pointing to main.py. Alternatively, you can install it automatically using the Smithery CLI by executing npx -y @smithery/cli@latest install @ruicarvalho1/mcp_nif --client claude in your terminal.

What can MCP NIF.PT do?

MCP NIF.PT queries Portuguese company information through the NIF.PT public API. It allows AI models to search companies by name and city, look up tax identification numbers (NIF), verify whether an enterprise is active or closed, retrieve addresses and contacts, find economic activity codes (CAE), and determine if an entity is an accounting business.

Which MCP clients work with MCP NIF.PT?

MCP NIF.PT works with Claude Desktop using the standard input and output transport layer. Because it is built using FastMCP and standard MCP protocols, it can also run in terminal environments, containerized setups with Docker, and any AI client supporting Model Context Protocol server configurations.

Is MCP NIF.PT open source?

Yes, MCP NIF.PT is an open-source project developed by Rui Carvalho. It is licensed under the permissive MIT License, allowing users to inspect, modify, and integrate the codebase. The full source code, including its FastMCP server logic, Dockerfile, and Pydantic models, is publicly accessible on GitHub.

What company information does MCP NIF.PT return?

The server returns comprehensive company details, including the business name, city, activity status, registered address with Google Maps links, phone numbers, email addresses, websites, and economic activity classification codes (CAE). It also provides external reference links to directories such as Racius and Portugalio.