MCP-RUES

Model Context Protocol (MCP) server for querying the Colombian Business Registry (RUES - Registro Único Empresarial y Social).

Quick Start

# Install dependencies
npm install

# Build
npm run build

# Add to Claude Code config (~/.config/claude-code/config.json):
{
  "mcpServers": {
    "rues": {
      "command": "node",
      "args": ["/path/to/mcp-rues/dist/server.js"]
    }
  }
}

Related MCP server: Brreg MCP Server

Features

• Search Companies by name with fuzzy matching

• Location Grouping to see companies by municipality/department

• Company Details including registration, economic activity, representatives

• DuckDB Caching for fast local data persistence

• Excel Parsing via Python/pandas for accurate data extraction

Available Tools

Installation

For complete installation instructions, including prerequisites, configuration, and troubleshooting, see INSTALL.md.

Requirements

• Node.js 18+

• Chrome/Chromium browser

• Python 3 + pandas + openpyxl

Usage Example

You: Search for companies named "Kaizen"

Claude: [Searching RUES...]

Found 119 companies:
- KAIZEN INSTITUTE COLOMBIA S A S (NIT: 900770772) - BOGOTA
- KAIZEN S.A.S (NIT: 901465503) - MEDELLIN
- KAIZEN GROUP S.A.S. EN LIQUIDACION (NIT: 900456887) - CALI
...

Architecture

MCP Tools → Service Layer → DuckDB Cache → Selenium Scraper → rues.org.co

License

MIT

Credits

Based on RUES scraping functionality for Colombian business registry queries.