MCP NIF.PT

by ruicarvalho1

Not rated
GitHub

About

Query and analyze Portuguese companies using the NIF.PT public API. Supports search by NIF, company name, and city.

Details

Author
ruicarvalho1
Categories
Search, Knowledge Base, Other

Setup

Install MCP NIF.PT in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/ruicarvalho1/MCP_Nif

Follow the installation instructions in the repository README, then restart your MCP client.

This project implements an intelligent server based onFastMCP, allowing you to query and analyze information about Portuguese companies using theNIF.PTpublic API. It supports multiple useful tools such as search by NIF, company name or city, checking company status, and identifying accounting-related businesses.

- 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)

. ├── main.py ├── models.py ├── nif_client.py ├── utils.py ├── requirements.txt ├── Dockerfile ├── package.json └── .smithery.profile.json

- FastMCP
- FastAPI
- httpx
- Pydantic
- Docker
- Python 3.10+

python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt python main.py

The application usestransport="stdio"by default, making it compatible with Claude Desktop or terminal-based environments.

- 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"?

- 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)

To integrate this MCP with Claude Desktop:
-

Install Claude Desktop
Download and install from:
https://claude.ai/download

Open Configuration
Go toFile > Settings > Developerand clickEdit Configuration

Add 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.

(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 claude

This will automatically install the MCP and register it with Claude Desktop.

This project is licensed under the MIT License.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.

Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/

Research tools, including a Sqlite-backed document stash

Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.

SerpApi MCP Server for Google and other search engine results

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.