Skip to main content
Glama

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: JUCESP: Busca de NIRE (pesquisa avançada)

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

Tool

Description

search_companies

Search by company name

get_locations

Group companies by location

get_company_details

Get detailed company information

get_companies_by_location

Filter companies by location

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.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Enables interaction with the Norwegian Business Registry (Brønnøysundregistrene) API to search and retrieve detailed information about Norwegian companies, subunits, roles, organization forms, municipalities, and NACE industry codes.
    18
    13 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables advanced search of companies in JUCESP by corporate name, object, capital, address, and other filters, returning the NIRE. Works with any MCP client via HTTP.
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables querying Mexico's SAT public lists to verify RFCs in bulk, search by business name, and obtain tax risk verdicts such as critical, high, medium, low, or clean.
    6
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables querying Taiwan's statutory company register by company name or 統一編號 to retrieve registration details such as capital, registered address, and current legal standing.
    8 npm
    MIT