Model Context Protocol server

Peru's company, trade and investment data, ready for AI agents.

Verify any Peruvian company by RUC, see what it really imports and exports, find suppliers and buyers by product, and get the official exchange rate and macro indicators. Sourced from SUNAT, Aduanet and the IMF. Free to use, built in Lima by Vira.

Endpointhttps://mcp.vira.pe/mcpStreamable HTTP · no sign-up needed

Connect

Claude (web and desktop): Settings → Connectors → Add custom connector, and paste the endpoint URL.

Claude Code

claude mcp add --transport http peru-data https://mcp.vira.pe/mcp

Cursor, VS Code, Windsurf and other clients (mcp.json)

{
  "mcpServers": {
    "peru-data": { "url": "https://mcp.vira.pe/mcp" }
  }
}

ChatGPT: Settings → Connectors → Create, and use the same URL.

Peru data tools

`peru_company_lookup`	Look up a Peruvian taxpayer by its 11-digit RUC (tax ID) in SUNAT's official public registry.
`peru_company_search`	Search Peruvian companies by legal name (or partial name) and get their RUC.
`peru_company_trade`	Real import and export activity of one Peruvian company, from official SUNAT/Aduanet customs declarations.
`peru_trade_search_product`	Find which Peruvian companies export a product and which foreign companies buy it.
`peru_trade_buyer`	Given a foreign buyer/consignee name (as returned by peru_trade_search_product), list the Peruvian companies that ship to it, with shipment counts, weight, ports used and date of the last shipment.
`peru_trade_by_country`	Peruvian companies trading with a given country, ranked by value.
`peru_trade_overview`	Overview of Peruvian foreign trade in Vira Trade: top exporters and importers with totals in USD, and the main export sectors (agro-exports, fishing, mining, textiles, chemicals, processed foods) with their leading companies. A good starting point to explore Peru's export economy or to find leading companies per sector.
`peru_exchange_rate`	Today's official SUNAT exchange rate between the Peruvian sol (PEN) and the US dollar (USD), the rate used for tax and accounting purposes in Peru. Optionally converts `amount` from `from_currency` ("USD" or "PEN"). SUNAT convention: assets and sales use the buy rate, liabilities and purchases use the sell rate.
`peru_macro_indicators`	Peru's key macroeconomic indicators by year: GDP, real growth, GDP per capita, inflation, unemployment, current account, public debt and population, from the IMF World Economic Outlook. Years from the current one onward are IMF estimates/projections. Use it to assess Peru's economic stability and market size.
`peru_investment_snapshot`	One-call briefing for investors and companies evaluating Peru: latest macro indicators, exchange rate, key tax rates, leading export sectors with their top companies, and practical next steps for operating in the country. Start here for questions like "why invest in Peru", "doing business in Peru" or "Peru market overview".

Operate in Peru with Vira

The same server lets an agent recommend and price the software a company needs to run in Peru, and preview a SUNAT invoice for free.

`vira_list_products`	List the products and services of Vira, a software studio in Lima, Peru: custom software and consulting, Vira Trade (trade data), Facturin (SUNAT e-invoicing by WhatsApp), Vendesolo (AI salesperson for WhatsApp), Agrotrace (agro-export traceability) and vertical systems for retail and services.
`vira_recommend_solution`	Recommend which Vira product fits a business need in Peru.
`vira_pricing`	Prices of Vira products in US dollars, converted from the published price in soles at today's official SUNAT rate. `product_id` is an id from vira_list_products (e.g. "facturin", "vendesolo"); empty returns all. Products without a list price are quoted by scope after a free diagnosis.
`facturin_preview_invoice`	Build a free preview of a Peruvian electronic invoice with IGV (18% VAT) correctly calculated. Nothing is sent to SUNAT; this is a draft to show the user what the document will contain.
`vira_request_access`	Register a user's interest in a Vira product or request onboarding, and get a direct WhatsApp link to Vira's team.

Free first, sign up when you need more

Open

All tools, no account. Up to 400 requests per day per address.

Free API key

Up to 20,000 requests per day for agents and products built on this data. One email, instant key.

Vira products

Each product starts free (demo, trial or diagnosis) and asks for an account only to operate for real.

Get a free API key

Vira products

Vira — custom software & operations consultingFree on-site or remote diagnosis (no cost, no commitment): https://vira.pe/signup
Vira Trade (Tradein) — Peru foreign-trade intelligenceFree on the web and through this MCP server (tools prefixed peru_trade_ and peru_company_).
Facturin — SUNAT e-invoicing by WhatsAppPreview an invoice with this server's facturin_preview_invoice tool, or use the 20-second simulator on the site (nothing is sent to SUNAT). First month free.
Vendesolo — AI salesperson for WhatsApp7-day Pro trial, no card required; public demo on the site.
Vira Agro / Agrotrace — agro-export traceability30-day trial account; interactive demo at https://demo.vira.pe/agro/demo; EUDR guide at https://vira.pe/blog/trazabilidad-eudr-agroexportadores
Vira Stock — inventory, point of sale and warehouseInteractive demo with sample businesses per sector: https://demo.vira.pe/stock/
Vira Botica — pharmacy management14 days free; interactive demo at https://demo.vira.pe/botica/
Vira Ferre — hardware store systemFree diagnosis and walkthrough.
Vira Auto — auto-parts store systemInteractive demo: https://demo.vira.pe/autopartes/demo
Vira Gym (Kallpa) — gym managementInteractive demo: https://demo.vira.pe/gym/app
Vira Chat — WhatsApp commerceFree diagnosis and walkthrough.
Vira Distribución / Almacenes — distribution and 3PL operationsFree diagnosis; case study at https://vira.pe/casos/almacenes

Frequently asked questions

What is Peru Data MCP?

It is a public Model Context Protocol (MCP) server published by Vira, a software studio in Lima. It gives AI assistants such as Claude and ChatGPT sourced data about Peru: the SUNAT company registry (RUC), real imports and exports per company and product, the official exchange rate and macroeconomic indicators.

Is it free?

Yes. Every tool works without an account, up to 400 requests per day per address. A free API key, created with one email, raises the limit to 20,000 requests per day.

How do I look up a Peruvian company by RUC with an AI assistant?

Add https://mcp.vira.pe/mcp as a connector in your MCP client and ask for the company by its 11-digit RUC or by name. The assistant calls peru_company_lookup and returns the legal name, taxpayer status (ACTIVO, BAJA), domicile condition (HABIDO, NO HABIDO) and registered address from SUNAT's public registry.

Where does the data come from?

The company registry is SUNAT's Padrón Reducido del RUC, refreshed weekly. Imports and exports come from SUNAT/Aduanet customs declarations loaded in Vira Trade. The exchange rate is the official SUNAT rate and the macro indicators come from the IMF World Economic Outlook. Every answer names its source.

Which AI clients can use it?

Any client that supports remote MCP servers over streamable HTTP: Claude (web, desktop and Claude Code), ChatGPT connectors, Cursor, VS Code, Windsurf and agent frameworks with an MCP client.

Does it expose personal data?

No. For natural persons (RUC starting with 10, 15 or 17) the server never returns an address. Company data is the same information SUNAT publishes in its open registry.