Skip to content
MCP server

Peru RUC Check

Check Peruvian RUC tax IDs against SUNAT's registry and get a pass, review or fail verdict

Status and history

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/mcp

Add to Settings → Connectors → Add custom connector

https://taxid.halpii.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "latam-tax-api": {
      "url": "https://taxid.halpii.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments