gitwtfhub

wtf is latam-data-mcp?

svkbogislav/latam-data-mcp — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5Setup · easy

TL;DR

An MCP server that gives AI agents 20 free tools for Latin American tax ID, bank, phone, and PIX validation plus exchange rates, holidays, and company lookups.

Mindmap

mindmap
  root((latam-data-mcp))
    What it does
      MCP server for AI agents
      Latin American data tools
      No API keys needed
    Tech stack
      Python
      FastMCP
      MCP protocol
    Use cases
      Validate tax IDs
      Check exchange rates
      Business day math
    Audience
      Developers building agents

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Validate a Chilean RUT, Mexican RFC, or other Latin American tax ID directly from an AI assistant conversation.

REASON 2

Check whether a Mexican CLABE or Brazilian PIX key is valid and see which bank it belongs to.

REASON 3

Look up live exchange rates like Argentina's blue dollar or Colombia's TRM rate for currency conversion.

REASON 4

Calculate holiday-aware business days between two dates for payroll or logistics planning.

What's in the stack?

PythonMCPFastMCP

How it stacks up

svkbogislav/latam-data-mcp0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires installing the uv runner and adding a config block to an MCP-compatible AI client, but needs no API keys.

Wtf does this do

This project is an MCP server, a small local program that gives AI assistants like Claude access to a specific set of tools. In this case those tools are all about Latin American data that is normally scattered across many sources, written only in Spanish, or otherwise hard for an AI agent to reach on its own. The server offers 20 tools in total. One group handles identity and business checks: validating national tax IDs with real check digit math across 15 countries, checking bank account codes such as Mexico's CLABE or Argentina's CBU, validating Brazilian PIX payment keys, normalizing phone numbers, and looking up Brazilian or Costa Rican companies by their registration number, including compliance status for anti money laundering checks. A second group covers money and markets, offering economic indicators like Chile's UF and UTM, Argentina's official and blue dollar exchange rates, Brazil's SELIC and CDI rates, Colombia's legally binding TRM rate, historical rate data, and currency conversion across 18 Latin American currencies. A third group deals with time, including public holidays for 20 countries, upcoming holidays, long weekends, and holiday aware business day counting for things like payroll or delivery schedules. Installing it requires no signup and no API keys. You install a small runner tool called uv, then add a short configuration block to your AI client, such as Claude Desktop or Claude Code, pointing it at this server. After that, you can simply ask your AI assistant a question in plain language, such as whether a specific tax ID is valid, and the assistant picks the right tool automatically. The basic tools described above are free forever. A paid Pro tier, priced at $19.99 a month, adds sanctions and watchlist screening, tax ID based company lookups for more countries, and bulk validation of up to 10,000 IDs at once, delivered as a hosted service rather than something you run yourself. The underlying data comes from free public government and financial APIs, and the tax ID validation itself is done with local math and no external dependencies.

Yoink these prompts

Prompt 1
Ask my AI assistant, using this MCP server, to validate a Brazilian CNPJ and tell me who the company is.
Prompt 2
Walk me through installing uv and adding this MCP server to my Claude Desktop config.
Prompt 3
How do I use this server's tools to convert an amount from Chilean pesos to Brazilian reais at the live rate?
Prompt 4
Show me how to check the number of business days between two dates in Chile using this server's holiday-aware tool.
Prompt 5
Explain what extra features the Pro tier of this MCP server adds over the free tools.

Frequently asked questions

wtf is latam-data-mcp?

An MCP server that gives AI agents 20 free tools for Latin American tax ID, bank, phone, and PIX validation plus exchange rates, holidays, and company lookups.

What language is latam-data-mcp written in?

Mainly Python. The stack also includes Python, MCP, FastMCP.

How hard is latam-data-mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is latam-data-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.