# MCP-RUES

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

## Quick Start

```bash
# 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"]
    }
  }
}
```

## 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](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.