Peru RUC Check
Check Peruvian RUC tax IDs against SUNAT's registry and get a pass, review or fail verdict
Answered our latest tool-list check 15 hours ago with 6 tools. It will be marked verified after 3 successful checks in 7 days.
- Pricing
- Free
- Platforms
- API
- Runs
- Remotely
- Version
- 0.1.0
- Listing updated
- 2 days ago
About Peru RUC Check
Peru RUC Check is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.
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.
Install
Run in a terminal
claude mcp add --transport http latam-tax-api https://taxid.halpii.com/mcpAdd to Settings → Connectors → Add custom connector
https://taxid.halpii.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"latam-tax-api": {
"url": "https://taxid.halpii.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"latam-tax-api": {
"type": "http",
"url": "https://taxid.halpii.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"latam-tax-api": {
"serverUrl": "https://taxid.halpii.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"latam-tax-api": {
"type": "http",
"url": "https://taxid.halpii.com/mcp"
}
}
}Tools this server provides (6)
Read directly from the server.
- 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
What it does
- 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
Pricing
Free
Free key: 100 lookups a day; pay-as-you-go listed as opening soon
Prices change. Check taxid.halpii.com before you buy.
Peru RUC Check 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 to Peru RUC Check

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments