Peru RUC Check

com.halpiiPublished by halpii.comOfficial publisherv0.1.0Updated Nov 14, 2026

Validate Peru company tax IDs (RUC) against SUNAT's public registry: status, address, verdict.

The publisher's own server: HALPII

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Validates Peruvian RUC tax IDs against SUNAT's public registry, returning check-digit validity, legal name, taxpayer status, fiscal address and a vendor…

What you can do
  • Validate a Peruvian RUC and look up the company in the official SUNAT registry
  • Get check-digit validity, legal name, taxpayer status and fiscal-address condition (HABIDO / NO HABIDO)
  • Retrieve the fiscal address with district and a pass/review/fail vendor assessment with reasons
When to use it
Use it to verify a Peruvian supplier or customer by RUC before paying, invoicing or onboarding, and to decide whether a vendor needs a human review.
Requirements
Remote streamable HTTP endpoint; no local runtime or package. An optional Authorization header with a bearer key, obtained from the provider's key endpoint, raises the daily lookup limit from 10 to 100.
Before you install
The Authorization header carries a secret API key; keep it private. Lookups without a key are limited to 10 per day. The verdict is an automated assessment and should not replace human review for high-value payments.

Installation

In SourceWeft

  1. Open Peru RUC Check in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.halpii%2Flatam-tax-api/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "peru-ruc-check": {
      "type": "http",
      "url": "https://taxid.halpii.com/mcp"
    }
  }
}

Tools

1

validate_peru_ruc

Validate Peru RUC (tax ID)

Validate a Peruvian RUC (11-digit tax ID) and look up the company in the official 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) only the check digit is validated, for privacy. Use it before paying or onboarding a Peruvian supplier.

Parametersrucrequired

Version history

1
  1. v0.1.0LatestNov 14, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Halpii integrations

HALPII

com.halpiiOfficial publisher

Public HALPII directory of tradespeople in Latin America: search professionals by need and city, view profiles, list trades, and build a request link.

Streamable HTTPWeb executable
Location & Lifestyle4 toolsNov 14, 2026