Skip to content
MCP server

Peru Data MCP by Vira

Verify Peruvian companies by RUC; read their customs trade, FX rate and macro data

Status and history

Answered our latest tool-list check 13 hours ago with 15 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About Peru Data MCP by Vira

Peru Data MCP by Vira is a free MCP server for analytics and data. It runs as a hosted remote server, so there is nothing to install locally.

Sourced data about Peru is served through tools that cover the SUNAT taxpayer register (Padrón Reducido, refreshed weekly), per-company import and export records from SUNAT and Aduanet declarations, the official sol–dollar exchange rate and IMF macro indicators. Sample answers on the site include checking that a RUC holder is active and in good standing, listing exporters of fresh blueberries with their RUCs and values, and converting dollars at the SUNAT buying rate.

The same server also carries tools for Vira, the Lima software studio behind it: listing and pricing its products, recommending a fit, previewing a Peruvian electronic invoice with 18% IGV calculated (nothing is sent to SUNAT), and requesting onboarding.

Every tool works without an account up to 400 requests a day per address. A free key requested with one email raises this to 20,000 a day.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "peru-data": {
      "url": "https://mcp.vira.pe/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "peru-data": {
      "type": "http",
      "url": "https://mcp.vira.pe/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (15)

Read directly from the server.

peru_company_lookup
Look up a Peruvian taxpayer by its 11-digit RUC (tax ID) in SUNAT's official public registry. Returns legal name, taxpayer status (ACTIVO, BAJA...), domicile condition (HABIDO, NO HABIDO), registered address for companies, and whether Vira Trade has import/export records for it. Also validates the RUC check digit. Use this to verify that a Peruvian supplier, client or counterparty exists and is in
peru_company_search
Search Peruvian companies by legal name (or partial name) and get their RUC. Returns companies with foreign-trade records first (with export/import totals in USD), then other matches from the SUNAT registry. Use the RUC with peru_company_lookup or peru_company_trade.
peru_company_trade
Real import and export activity of one Peruvian company, from official SUNAT/Aduanet customs declarations. Returns totals in USD (FOB exports, CIF imports), yearly breakdown, top destination and origin countries, customs offices used and a sample of exported products. If the company is not loaded yet, it is fetched on demand (may take a few seconds). Use it for supplier due diligence, competitor a
peru_trade_search_product
Find which Peruvian companies export a product and which foreign companies buy it. `product` is a keyword, ideally in Spanish as written in customs declarations (e.g. "arandano" for blueberry, "palta" for avocado, "uva" for grape, "cobre" for copper, "harina de pescado" for fishmeal, "cacao", "cafe"). Returns Peruvian exporters (with RUC and total exports) and foreign consignees (with shipment cou
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. `country_code` is the ISO 3166-1 alpha-2 code (US, CN, NL, ES, CL, JP, KR, DE, BR...). Returns each company's exports to and imports from that country in USD. Use it to find who in Peru already sells to or buys from a market.
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".
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. `category` optionally filters: "consulting", "data", "saas" or "vertical". Each product states what is f
vira_recommend_solution
Recommend which Vira product fits a business need in Peru. `problem` is the need in plain words, English or Spanish (e.g. "I need to issue invoices valid in Peru", "my WhatsApp gets more messages than I can answer", "track fruit lots for EUDR", "I lose stock and don't know where"). `business_type` is optional (e.g. "pharmacy", "agro-exporter", "hardware store", "distributor"). Returns up to three
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. `items`: list of {"description": str, "quantity": number, "unit_price": number}. `document_type`: "boleta" (receipt for consumers) or "factura" (invoice for companies; requires `customer_ruc`). `prices_include_igv`
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. `product_id` is an id from vira_list_products. `business_type` (e.g. "pharmacy with 2 locations") and `location` (city, country) help Vira prepare. `contact` (email or phone) is optional and must only be passed if the user explicitly provided it for this purpose; without it the reques

What it does

RUC lookup
Returns legal name, taxpayer status, domicile condition and address from SUNAT.
Company trade activity
Real import and export totals from customs declarations.
Product and buyer search
Finds which companies export a product and who buys it.
Exchange rate
Official SUNAT buy and sell rates with optional conversion.
Macro indicators
GDP, inflation, unemployment and debt by year from the IMF outlook.
Invoice preview
Free draft of a Peruvian e-invoice with IGV.

Good for

  • Check a supplier's tax status before paying
  • Find Peruvian exporters of a product
  • Convert amounts at the SUNAT rate for accounting
  • Prepare an investment briefing on Peru

Pricing

Free

Free; free API key raises the daily limit

Prices change. Check mcp.vira.pe before you buy.

Peru Data MCP by Vira FAQ

Is it free?

Yes: 400 requests a day per address without an account, 20,000 with a free key.

Where does the data come from?

SUNAT's RUC register, SUNAT/Aduanet customs declarations, SUNAT exchange rates and the IMF World Economic Outlook.

Does the invoice tool send anything to SUNAT?

No, it only builds a preview draft.

Is Peru Data MCP by Vira free?

Yes. Peru Data MCP by Vira is free to use.

How do I add Peru Data MCP by Vira to Claude Code?

Run this command in your terminal: claude mcp add --transport http peru-data https://mcp.vira.pe/mcp

What are the best alternatives to Peru Data MCP by Vira?

The closest alternatives to Peru Data MCP by Vira are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Peru Data MCP by Vira

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

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

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. 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