MCP server exposing 2 tools for peru-sunat-ruc.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/peru-sunat-ruc/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}pe_ruc — Look up one Peruvian taxpayer by its 11-digit RUC in SUNAT's published taxpayer register: registered name (razon social), taxpayer status (active, deregistered, suspended ...), domicile condition (habido / no habido ...) and, for companies, the registered address with its ubigeo and department. Companies and organisations only (RUC prefix 20, plus government offices 00): natural persons (RUCs beginning 10, 15, 17) are excluded and answer found:false with reason natural_person_not_served, no name, status or address. Use for "is RUC 20100070970 real and active", KYC and counterparty checks, or resolving a RUC found on an invoice.pe_ruc_search — Search SUNAT's published taxpayer register by company name (razon social) -- legal entities only (RUC prefix 20 and government offices); natural persons are excluded entirely and are never returned. Accent-insensitive substring match: every word of 3+ letters must appear in the name. Active registrations are listed before deregistered ones. Optionally restrict to a place with a ubigeo prefix (2 digits = department, e.g. "15" Lima; 4 = province; 6 = district). Returns RUC, name, status and address so you can pick the right one.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/peru-sunat-ruc/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io