mcp-colombia-hub connects AI agents to Colombian services for shopping, travel, real estate, and finance — with verified identity and behavior reputation tracking via Soulprint.
🛍️ Search MercadoLibre products: Find products with prices, seller info, free shipping, and purchase links, filterable by category, price range, and sort order.
🔍 Get product details: Retrieve full details for a specific MercadoLibre item by ID (e.g., MCO123456789).
✈️ Search flights: Find domestic and international flights to/from Colombia (with links to Avianca, LATAM, and Skyscanner), filtered by origin, destination, dates, and passengers.
🏨 Search hotels: Look up hotels in Colombian cities for specific dates, with Booking.com links and price filtering in COP.
🏠 Search real estate: Browse apartments and houses for rent or sale via FincaRaíz, MetroCuadrado, and Ciencuadras, filtered by city, price, rooms, and neighborhood.
💳 Compare CDTs: Compare Certificados de Depósito a Término across Colombian banks by investment amount and term.
💰 Simulate loans: Calculate monthly payments and total cost for consumer/personal credits at major Colombian banks and fintechs.
🏦 Compare bank accounts: Compare savings accounts and digital wallets, including yield rates, maintenance fees, and GMF tax info.
🪪 Soulprint identity & reputation: Check your Soulprint score, DID, and reputation status. All tool usage is tracked for spam detection and reputation building.
🔒 Job applications (premium): Apply for jobs with verified identity, requiring a Soulprint score of 40 or higher.
Enables searching for flight availability, routes, and schedules to and from Colombia through Avianca's services.
Utilizes the Brave Search API as a fallback mechanism to provide real-time web search results for Colombian products and services.
Allows for the comparison of investment yields and terms for fixed-term deposit (CDT) products offered by Nu Colombia.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-colombiaBusca una freidora de aire en MercadoLibre por menos de 300 mil pesos"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🇨🇴 mcp-colombia-hub
MCP server que conecta cualquier agente de IA con servicios colombianos — con identidad verificada y reputación de comportamiento mediante Soulprint.
🚀 Instalación en 30 segundos
Claude Desktop / Cursor / Copilot
Edita tu archivo de configuración MCP:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonMac:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-colombia": {
"command": "npx",
"args": ["-y", "mcp-colombia-hub"]
}
}
}Con identidad verificada (endpoints premium):
{
"mcpServers": {
"mcp-colombia": {
"command": "npx",
"args": ["-y", "mcp-colombia-hub"],
"env": {
"SOULPRINT_TOKEN": "tu-token-aqui"
}
}
}
}🛠️ Herramientas disponibles
🛍️ MercadoLibre (Colombia)
Tool | Descripción |
| Busca productos con precio, vendedor y link directo |
| Detalle completo de un producto por ID |
✈️ Viajes
Tool | Descripción |
| Vuelos desde/hacia Colombia (via Booking.com) |
| Hoteles con precio por noche en pesos colombianos |
💰 Finanzas
Tool | Descripción |
| Compara CDTs de bancos colombianos |
| Simula créditos (cuota mensual, total a pagar) |
| Compara cuentas de ahorro y corrientes |
🏠 Inmuebles
Tool | Descripción |
| Busca apartamentos/casas en venta o arriendo (Ciencuadras) |
🌀 Soulprint (identidad y reputación)
Tool | Descripción | Requiere |
| Ver tu score, DID, sesión y reputación | Opcional |
| PREMIUM — Aplica a empleos con identidad verificada | Score ≥ 40 |
🌀 Integración con Soulprint
mcp-colombia-hub es el primer servicio verificado del ecosistema Soulprint. Cada llamada a las herramientas es monitoreada automáticamente:
Comportamiento → Reputación
🔴 Spam (>5 requests en 60s) → -1 attestation a tu DID
🟢 Uso normal (3+ tools, 3+ completions sin spam) → +1 attestationEndpoint premium — trabajo_aplicar
Requiere Soulprint score ≥ 40 (identidad básica verificada):
# Verificar tu identidad primero
npx soulprint verify-me --selfie yo.jpg --document cedula.jpg
# El token se inyecta automáticamente vía SOULPRINT_TOKENRespuesta de trabajo_aplicar:
{
"application_id": "SP-M9X3K2-Z6MK4F",
"applicant": {
"did": "did:key:z6Mk...",
"score": 97,
"verified": true
},
"trust_guarantees": {
"human_verified": true,
"no_spam_history": true,
"zkp": true
}
}Los empleadores ven un candidato verificado — sin nombre, sin cédula, solo prueba matemática de que eres un humano real con historial limpio.
📦 Estructura del proyecto
src/
├── index.ts # Servidor MCP principal (10 tools)
├── tools/
│ ├── mercadolibre.ts # Búsqueda ML con fallback Brave Search
│ ├── booking.ts # Vuelos + hoteles (Booking.com / Awin)
│ ├── finanzas.ts # CDT, crédito, cuentas
│ └── inmuebles.ts # Ciencuadras JSON-LD scraping
└── soulprint/
├── service-identity.ts # DID del servicio, token SPT (score=80)
├── behavior-tracker.ts # Tracking spam/recompensas por DID
└── middleware.ts # extractToken(), verifySoulprint(), requireSoulprint()
tests/
└── soulprint.test.ts # 37 tests (unit + integración + pen tests)🧪 Tests
npm test[A] TESTS UNITARIOS (16 tests)
✅ Service identity — DID, keypair, token score=80
✅ Behavior tracker — spam detection, rewards, error reset
✅ Middleware — token extraction, verification, minScore
[B] TESTS DE INTEGRACIÓN (12 tests)
✅ Bot anónimo — tools básicas OK, trabajo_aplicar BLOQUEADO
✅ Bot low-score — bloqueado del endpoint premium
✅ Bot premium (score=100) — acceso total
✅ Ciclo de recompensa — +1 tras 3 completions en 3 tools
✅ Ciclo de penalización — -1 tras spam detectado
[C] TESTS DE PENETRACIÓN (9 tests)
✅ Score inflation ×50 → RECHAZADO
✅ DID substitution ×20 → RECHAZADO
✅ 100 fake attestations → SCORE SIN CAMBIO
✅ Sybil attack → BLOQUEADO por nodo
✅ Spam en endpoint premium → -1 rep
Total: 37/37 ✅🔧 Desarrollo
git clone https://github.com/manuelariasfz/mcp-colombia
cd mcp-colombia
npm install
npm run build
npm testVariables de entorno opcionales:
BRAVE_API_KEY=... # Para búsqueda fallback en ML
SOULPRINT_NODE=http://... # Nodo Soulprint (default: localhost:4888)
SOULPRINT_TOKEN=... # Token SPT del bot usuario🤝 Relación con Soulprint
Proyecto | Rol |
Protocolo de identidad (7 paquetes npm) | |
mcp-colombia-hub | Primer servicio verificado del ecosistema |
📄 Licencia
MIT — Felipe Arias · @manuelariasfz