# HALPII Tax ID (remote · taxid.halpii.com)

Tax IDs in 135 countries: official registry check in 51 (Peru, Brazil, Chile, EU VIES, UK, Japan).

- Trust score: 74/100 (medium)
- Change this week: −4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `taxid.halpii.com`: 74/100 (this document), [markdown](https://verifymcp.io/servers/com-halpii-latam-tax-api/taxid.md), [page](https://verifymcp.io/servers/com-halpii-latam-tax-api/taxid)

## Channel facts

- Endpoint: `https://taxid.halpii.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.7.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 59/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2847 tokens (~474/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 6 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 7 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the HALPII Tax ID MCP server?

HALPII Tax ID is a hosted endpoint at https://taxid.halpii.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http com-halpii-latam-tax-api 'https://taxid.halpii.com/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "com-halpii-latam-tax-api": {
      "url": "https://taxid.halpii.com/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-halpii-latam-tax-api": {
      "type": "http",
      "url": "https://taxid.halpii.com/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-halpii-latam-tax-api]
url = "https://taxid.halpii.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-halpii-latam-tax-api": {
      "type": "remote",
      "url": "https://taxid.halpii.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-halpii-latam-tax-api --url 'https://taxid.halpii.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-halpii-latam-tax-api:
    url: "https://taxid.halpii.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "com-halpii-latam-tax-api": {
      "Transport": "http",
      "Url": "https://taxid.halpii.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-halpii-latam-tax-api -t streamable-http -u 'https://taxid.halpii.com/mcp'
```

### Other

```json
{
  "mcpServers": {
    "com-halpii-latam-tax-api": {
      "type": "http",
      "url": "https://taxid.halpii.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 74, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “validate_colombia_nit” rewrote its description, which is the text the model reads
- [security] Tool “validate_costa_rica_cedula” rewrote its description, which is the text the model reads
- [security] Tool “validate_peru_ruc” rewrote its description, which is the text the model reads
- [security] Tool “validate_tax_id” rewrote its description, which is the text the model reads
- [security] Tool “validate_tax_id_format” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 345 → 474
- [functional regression] Schema quality: 345 → 401
- [cosmetic] “validate_tax_id” reworded the description of “country”
- [cosmetic] “validate_tax_id” reworded the description of “id_type”

### 2026-11-20 (score 74, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “validate_tax_id_format” rewrote its description, which is the text the model reads
- [cosmetic] Tool “validate_tax_id_format” changed its title: Check tax ID format (about 50 countries) → Check tax ID format (more than 100 countries and territories)

### 2026-11-19 (score 74, +1)

- [cosmetic] “validate_colombia_nit” reworded the description of “nit”
- [cosmetic] “validate_costa_rica_cedula” reworded the description of “cedula”
- [cosmetic] “validate_mexico_rfc” reworded the description of “rfc”
- [cosmetic] “validate_peru_ruc” reworded the description of “ruc”
- [cosmetic] “validate_tax_id” reworded the description of “id”
- [cosmetic] “validate_tax_id_format” reworded the description of “id”

### 2026-11-17 (score 73, +3)

- [security improvement] HSTS header: fail → pass

### 2026-11-16 (score 70, −2)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “validate_peru_ruc” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 231 → 335
- [functional] Server version: 0.1.0 → 0.4.0
- [functional] New tool “validate_colombia_nit”
- [functional] New tool “validate_costa_rica_cedula”
- [functional] New tool “validate_mexico_rfc”
- [functional] New tool “validate_tax_id”
- [functional] New tool “validate_tax_id_format”

### 2026-11-15 (score 72, −6)

- [security regression] Authorization: pass → partial
- [security] Tool “validate_peru_ruc” rewrote its description, which is the text the model reads
- [functional improvement] Stability: unverified → 0.03

### 2026-11-14 (score 78)

First indexed and scored.

## MCP tools (6)

### `validate_peru_ruc` (~233 tokens)

Validate Peru RUC (tax ID)

Validate a Peruvian RUC (11-digit tax ID) and look up the company in the SUNAT registry. Returns check-digit validity, legal name, taxpayer status (active or not), fiscal-address condition (HABIDO / NO HABIDO), fiscal address with district, and a pass/review/fail vendor assessment with reasons. Full data is returned for company RUCs (prefix 20). For natural-person RUCs (prefix 10, 15, 16, 17) the taxpayer status and address condition are returned; the holder's name is returned only when the connector is used with an API key (?api_key=... or Authorization header), for supplier and customer verification; never the DNI or address (privacy, Ley 29733). If that registry data is unavailable the answer is a check-digit validation with verification_level "format". Typical use: checking a Peruvian supplier or customer before paying, invoicing or onboarding it.

Input parameters:

- `ruc` (string, required): 11-digit Peru RUC, e.g. "20615614841". Spaces and dashes are ignored.

### `validate_mexico_rfc` (~192 tokens)

Check Mexico RFC (tax ID)

Check a Mexican RFC (12 characters for companies, 13 for individuals): structure, encoded date and SAT check digit, plus whether it appears on SAT's public lists under article 69-B of the Código Fiscal de la Federación (taxpayers presumed or confirmed to invoice non-existent operations, also called EFOS) and article 69 (not located, unpaid or cancelled tax debts, tax-crime convictions). Returns the list status with publication dates and a review/fail assessment with reasons. Mexico publishes no RFC registry, so the result never confirms that an RFC is registered or active and never returns pass. Company names are returned only when a SAT list carries them; individuals get list status only, without name or birth date.

Input parameters:

- `rfc` (string, required): Mexican RFC, 12 or 13 characters, e.g. "SAT970701NN3". Case, spaces and dashes are ignored.

### `validate_colombia_nit` (~171 tokens)

Validate Colombia NIT (tax ID)

Validate a Colombian NIT with the DIAN check-digit algorithm and look it up live in the RUES commercial registry kept by the chambers of commerce (Confecámaras, licensed CC BY-SA 4.0). Returns the computed check digit, legal name, registration status (active, cancelled and others), last renewal year, registration dates, chamber of commerce, legal form, CIIU activity codes and a pass/review/fail assessment with reasons. This is the commercial registry, not DIAN tax status. For individuals only the check digit and registration status are returned, without name or address.

Input parameters:

- `nit` (string, required): Colombian NIT with or without the check digit, e.g. "899999068-1" or "899999068". Dots and spaces are ignored.

### `validate_costa_rica_cedula` (~179 tokens)

Validate Costa Rica cédula (tax ID, beta)

Check a Costa Rican tax ID (cédula física, cédula jurídica, DIMEX or NITE) live against the Ministerio de Hacienda. Returns the ID type, taxpayer status (registered or not), tax regime, delinquent (moroso) and non-filer (omiso) flags, tax administration office, registered economic activities and a pass/review/fail assessment with reasons. Beta: the meaning of some Hacienda fields is not formally documented. Names are returned only for legal entities; for individuals the name is withheld.

Input parameters:

- `cedula` (string, required): Costa Rican ID: 9 digits (cédula física), 10 digits (cédula jurídica or NITE) or 11-12 digits (DIMEX), e.g. "2-100-042005". Dashes are ignored.

### `validate_tax_id_format` (~463 tokens)

Check tax ID format (more than 100 countries and territories)

Check the format of a business tax or registry ID offline: structure and, where the issuing authority publishes one, the check digit (VIES and the registries are never queried here). Covers EU VAT numbers for all 27 member states (plus Spain NIF, France SIREN/SIRET, Finland Y-tunnus, Sweden organisationsnummer), United Kingdom VAT and company number, Switzerland UID, Norway, Iceland, Türkiye, United States EIN (structure only), Canada BN, Brazil CNPJ (including the alphanumeric format), Argentina, Chile RUT, Ecuador, Uruguay, Paraguay, Bolivia, Guatemala, Panama, Dominican Republic (RNC and cédula), Venezuela, Australia ABN/ACN, New Zealand NZBN/IRD, India GSTIN/PAN, Japan, South Korea, Taiwan, Singapore, Israel and South Africa, and 63 more countries and territories (among them China, Russia, Ukraine, Indonesia, Thailand, Vietnam, Kazakhstan, Morocco, Ghana, Kenya, Nigeria, the United Arab Emirates and Saudi Arabia; some of those have no published check digit, so only the structure is checked). Returns the normalized ID, format and check-digit validity, verification_level "format", a review/fail assessment with reasons and, when one exists, the URL of the free official lookup. No registry is queried, so the result never confirms that the business exists or is active and never returns pass.

Input parameters:

- `country` (string, required): ISO 3166-1 alpha-2 country code, e.g. "DE", "FR", "BR", "GB". "EL" is accepted for Greece and "UK" for the United Kingdom.
- `id` (string, required): The ID as written, with or without the country prefix, spaces, dots or dashes, e.g. "DE 123 456 807" or "12.345.678/9013-11".
- `id_type` (string): Optional ID type when the country has several, e.g. "vat", "siren", "siret", "nif", "crn", "abn", "acn", "gstin", "pan", "nzbn", "ird". Detected from the input when omitted.

### `validate_tax_id` (~1347 tokens)

Validate a business tax ID (any supported country)

Validate a business tax or registry ID for any supported country with the deepest check available for it. Norway (organisation number), Finland (Y-tunnus or VAT), France (SIREN, SIRET or VAT), Ireland (CRO company number) and Taiwan (unified business number) are checked live against the official registry: legal name, status (active, dissolved, bankrupt, struck off and others), address, key dates, the source with its licence and the date of the data, verification_level "official_registry" and a pass/review/fail assessment with reasons. Ireland comes from CRO data updated daily, not a live query. Dominican Republic RNC (9 digits) is checked against the DGII RNC register, updated daily (legal and trade name, status, activity, payment regime); an 11-digit cédula of a natural person gets the format check only, without any name. Chile RUT is checked against the SII register of legal entities (updated a few times a year: see source.data_as_of): name, legal form, start date and término de giro (closure = fail). Canada BN (9 digits, or with a program account such as RT0001) is checked against the Corporations Canada register of federal corporations, updated daily (Open Government Licence – Canada): name, status, registered office, dates; it covers federal corporations only, so a BN not found is review, never fail. Argentina CUIT (legal entities, prefixes 30, 33, 34) is checked against the ARCA register of tax conditions: name and registration in Ganancias and IVA (registered, active or exempt, in either = pass; ARCA states no active flag). Paraguay RUC is checked against the DNIT RUC register (monthly): status, plus the name of legal entities only (natural persons: status only). Ecuador RUC (companies and other entities, third digit 6 or 9) is checked against the SRI RUC register (monthly): name, status (ACTIVO = pass, SUSPENDIDO = review, PASIVO = fail), class and dates. Natural persons of Argentina and Ecuador get the format check only (review), without any name. Brazil C…

Input parameters:

- `country` (string, required): ISO 3166-1 alpha-2 country code, e.g. "NO", "FI", "FR", "IE", "TW", "DO", "CL", "AR", "PY", "EC", "BR", "CA", "DE", "IT", "CH", "SG", "GB", "PE". "EL" is accepted for Greece and "UK" for the United K…
- `id` (string, required): The ID as written, with or without the country prefix, spaces, dots or dashes, e.g. "974761076", "1003521-5", "FR90130004955", "98788", "03741302".
- `id_type` (string): Optional ID type when the country has several, e.g. "siren", "siret", "vat", "ytunnus", "cro", "orgnr", "ubn", "rnc", "cedula", "rut", "bn", "ico", "uid", "uen", "crn". Detected from the input when o…

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-halpii-latam-tax-api/taxid#diagnostics

## Score history

- 2026-11-21: 74
- 2026-11-20: 74
- 2026-11-19: 74
- 2026-11-18: 73
- 2026-11-17: 73
- 2026-11-16: 70
- 2026-11-15: 72
- 2026-11-14: 78

## Common questions

### What is the HALPII Tax ID MCP server?

HALPII Tax ID is an MCP server listed in the public MCP registry as com.halpii/latam-tax-api. Tax IDs in 135 countries: official registry check in 51 (Peru, Brazil, Chile, EU VIES, UK, Japan). This page covers its hosted endpoint (https://taxid.halpii.com/mcp).

### Is the HALPII Tax ID MCP server safe to use?

HALPII Tax ID scores 74 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the HALPII Tax ID MCP server expose?

HALPII Tax ID exposes 6 tools: validate_peru_ruc, validate_mexico_rfc, validate_colombia_nit, validate_costa_rica_cedula, validate_tax_id_format, validate_tax_id. Their descriptions and schemas cost roughly 2,585 tokens of context every time the server is loaded.

### Does the HALPII Tax ID MCP server require authentication?

No. We connected to HALPII Tax ID without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the HALPII Tax ID MCP server still maintained?

HALPII Tax ID is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the HALPII Tax ID MCP server?

VerifyMCP ran 13 checks on HALPII Tax ID, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://taxid.halpii.com/mcp
- Website: https://taxid.halpii.com/
- Changelog RSS feed: https://verifymcp.io/servers/com-halpii-latam-tax-api/taxid.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-halpii-latam-tax-api/taxid/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/com-halpii-latam-tax-api/taxid.json
- HTML version of this page: https://verifymcp.io/servers/com-halpii-latam-tax-api/taxid
