MCP NIF.PT
Provides links to Google Maps locations for Portuguese company addresses retrieved from the NIF.PT API
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP NIF.PT
This project implements an intelligent server based on FastMCP, allowing you to query and analyze information about Portuguese companies using the NIF.PT public API. It supports multiple useful tools such as search by NIF, company name or city, checking company status, and identifying accounting-related businesses.
Features
Retrieve complete company data by NIF
Check if a company is active or closed
Identify if a company is related to accounting
Search companies by name and city
Get the NIF based on the exact company name
Access external links (Google Maps, Racius, Portugalio)
Related MCP server: cnpj-br
Project Structure
.
├── main.py
├── models.py
├── nif_client.py
├── utils.py
├── requirements.txt
├── Dockerfile
├── package.json
└── .smithery.profile.json Technologies Used
FastMCP
FastAPI
httpx
Pydantic
Docker
Python 3.10+
How to Run
Locally
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python main.pyThe application uses transport="stdio" by default, making it compatible with Claude Desktop or terminal-based environments.
Usage Examples
Qual é a empresa com o NIF 504426744?
A empresa com o NIF 504426744 está ativa?
A empresa com o NIF 504426744 é de contabilidade?
Procurar empresas com o nome "contabilidade" em Lisboa
Qual é o NIF da empresa "XPTO LDA"?
Output Format
The responses include details such as:
Nome, cidade, atividade e estado
Morada com link para Google Maps
Contactos (telefone, email, website)
CAE (Código de Atividade Económica)
Ligações externas (Racius, Portugalio)
Claude Desktop Integration
To integrate this MCP with Claude Desktop:
Install Claude Desktop
Download and install from: https://claude.ai/downloadOpen Configuration
Go toFile > Settings > Developerand click Edit ConfigurationAdd the MCP server configuration
In theclaude_desktop_config.json, insert the following configuration:
{
"mcpServers": {
"nif-pt-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER",
"run",
"main.py"
]
}
}
}Replace
/ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDERwith the actual absolute path where yourmain.pyfile is located.
Restart Claude Desktop
After saving the configuration, restart Claude Desktop. Yournif-pt-serverMCP should now be available in the Claude Desktop interface.
One-Click Installation via Smithery
(https://smithery.ai/server/@ruicarvalho1/mcp_nif)
With Claude Desktop open, you can install this MCP directly using the Smithery CLI.
Just paste the following command into your terminal:
npx -y @smithery/cli@latest install @ruicarvalho1/mcp_nif --client claudeThis will automatically install the MCP and register it with Claude Desktop.
Author
Developed by Rui Carvalho.
License
This project is licensed under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Validate EU VAT numbers in VIES and read the Portuguese VAT Code and RITI in Portuguese or English.
Find Brazilian companies by business activity (CNAE), location, company size, and registration status, using data from Brazil’s Federal Revenue Service. The Oportunidados MCP connector offers 24 tools to search and consult companies, view account information, and work in the account’s CRM. It reads company data and reads and writes CRM records, including deletions. Write and delete tools are labeled as such, so your AI client can ask for confirmation.
Agent-native API for Finnish public company data via YTJ. Pay-per-call $0.01 USDC over x402.
Company by CNPJ, CEP, holidays, area codes, banks, NCM, Selic, CDI and IPCA, and CPF and CNPJ checks
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Brazilian electronic invoices (NF-e, NFC-e, NFS-e) via Nuvem Fiscal API, including CNPJ lookup, invoice issuance, cancellation, and PDF generation.161MIT
- AlicenseNot gradedqualityCmaintenanceBrazilian company-registry lookup via Receita Federal, allowing AI agents to query CNPJ data.59 npmMIT
- AlicenseBqualityCmaintenanceEnables AI assistants and automation tools to query and analyze Brazilian fiscal data, including CNPJ, Simples Nacional, NF-e, NFS-e, SPED, eSocial, tax regime comparison, and supplier risk assessment without requiring API keys.44MIT

apipj MCP serverofficial
AlicenseNot gradedqualityCmaintenanceEnables lookup and validation of Brazilian companies by CNPJ, returning registration status, address, CNAE activities, Simples Nacional/MEI status, and partners from monthly Receita Federal open data, plus validation of numeric or alphanumeric CNPJ check digits and search of active companies by activity and municipality.MIT