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: 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

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
    F
    maintenance
    Enables interaction with the French business search API from data.gouv.fr, allowing users to search for French companies by text or geographical criteria and access essential business information.
    2
    17 npm
    19
    MIT
  • 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
    5 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides access to Norway's official business registry for searching companies, looking up organizational details, and identifying company roles and sub-units. It utilizes data from Brønnøysundregistrene to enable detailed queries by industry, municipality, or organization number.
    5 npm
    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