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: com.qorpiq/mca

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • 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
      A
      quality
      C
      maintenance
      Enables read-only lookups of Indian company and director records, including CIN, LLPIN, FCRN, DIN, registry status, and recent incorporations. It also supports company name searches and director directorship histories.
      6
      65 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables lookup and validation of Brazilian companies by CNPJ, returning registration status, address, CNAE activities, Simples Nacional/MEI status, and partners from monthly Receita Federal open data, plus validation of numeric or alphanumeric CNPJ check digits and search of active companies by activity and municipality.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to look up Colombian company registry, sanctions, restricted-party lists, and public procurement records — including contracts, bidders, consortia, and process documents — all cross-referenced by NIT and returned with the official source and capture date behind every figure.
      MIT