# Peru RUC Check

> Peru RUC Check is a free MCP server for finance and payments. Check Peruvian RUC tax IDs against SUNAT's registry and get a pass, review or fail verdict. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://taxid.halpii.com
- **MCP Registry name:** com.halpii/latam-tax-api
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-15

## About

Results come with a verification level, so a caller knows whether the number was found in an official registry or only passed a format check. For Peru the source is the SUNAT Padrón Reducido, and the answer also reflects the HABIDO or NO HABIDO flag, which says whether SUNAT could verify the taxpayer's fiscal address. A NO HABIDO result moves the verdict to review.

The server is the Peru entry of a wider tax ID service from HALPII that covers 58 countries. It is aimed at accounts payable, procurement and KYB teams who want to check a supplier before paying, and at agent builders who want a remote MCP endpoint instead of calling REST themselves.

The service is independent of the tax authorities it queries. It does not screen sanctions lists, politically exposed persons or adverse media.

## Features

- **RUC registry lookup:** Checks a Peruvian RUC against SUNAT's public registry and returns status and address.
- **Three-level verdicts:** Every answer is labelled pass, review or fail with reasons.
- **Address verification flag:** Reflects whether SUNAT lists the taxpayer as HABIDO or NO HABIDO.
- **Dated source data:** Each response names the official source and the date of its data.
- **Keyless MCP access:** Works without a key under a shared daily allowance; an API key raises the quota.

## Good for

- Verify a new Peruvian supplier's RUC before the first payment
- Screen vendors during procurement onboarding
- Keep a dated verification record for KYB files
- Let an AI assistant confirm a RUC while reviewing an invoice

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://taxid.halpii.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `validate_peru_ruc`: Validate a Peruvian RUC (11-digit tax ID) and look up the company in the public SUNAT registry file (Padrón Reducido del RUC). 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-pe
- `validate_mexico_rfc`: 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 th
- `validate_colombia_nit`: 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 open data on datos.gov.co, 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
- `validate_costa_rica_cedula`: Check a Costa Rican tax ID (cédula física, cédula jurídica, DIMEX or NITE) live against the Ministerio de Hacienda's public taxpayer lookup. 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 Hacienda endpoint is not
- `validate_tax_id_format`: Check the format of a business tax or registry ID offline: structure and, where the issuing authority publishes one, the check digit. 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
- `validate_tax_id`: 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 open registry: legal name, status (active, dissolved, bankrupt, struck off and others), address, key da

## FAQ

### Does it work without an API key?

Yes. AI assistants share 500 keyless lookups a day; adding an api_key to the URL uses your own quota.

### What does a NO HABIDO result do?

It makes the verdict review, so a person should look before paying.

### Does it check sanctions lists?

No. The flags come from tax authorities only; it does not check OFAC, UN or EU sanctions, PEPs or adverse media.

### How many lookups does a free key allow?

100 a day, across every country, over REST and MCP.

### Is Peru RUC Check free?

Yes. Peru RUC Check is free to use.

### How do I add Peru RUC Check to Claude Code?

Run this command in your terminal: claude mcp add --transport http latam-tax-api https://taxid.halpii.com/mcp

### What are the best alternatives to Peru RUC Check?

The closest alternatives to Peru RUC Check are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/peru-ruc-check
