README.md
Connect AI agents with Colombian e-commerce, travel, and financial services.
🇨🇴 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.json - Mac:
~/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 |
|---|---|
ml_buscar_productos |
Busca productos con precio, vendedor y link directo |
ml_detalle_producto |
Detalle completo de un producto por ID |
✈️ Viajes
| Tool | Descripción |
|---|---|
viajes_buscar_vuelos |
Vuelos desde/hacia Colombia (via Booking.com) |
viajes_buscar_hotel |
Hoteles con precio por noche en pesos colombianos |
💰 Finanzas
| Tool | Descripción |
|---|---|
finanzas_comparar_cdt |
Compara CDTs de bancos colombianos |
finanzas_simular_credito |
Simula créditos (cuota mensual, total a pagar) |
finanzas_comparar_cuentas |
Compara cuentas de ahorro y corrientes |
🏠 Inmuebles
| Tool | Descripción |
|---|---|
inmuebles_buscar |
Busca apartamentos/casas en venta o arriendo (Ciencuadras) |
🌀 Soulprint (identidad y reputación)
| Tool | Descripción | Requiere |
|---|---|---|
soulprint_status |
Ver tu score, DID, sesión y reputación | Opcional |
trabajo_aplicar |
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 attestation
Endpoint 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_TOKEN
Respuesta 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
Tools (10)
ml_buscar_productosSearch for products on MercadoLibre with price, seller, and direct link.ml_detalle_productoGet full details of a product by ID.viajes_buscar_vuelosSearch for flights to/from Colombia via Booking.com.viajes_buscar_hotelSearch for hotels with price per night in Colombian pesos.finanzas_comparar_cdtCompare CDTs from Colombian banks.finanzas_simular_creditoSimulate loans including monthly payment and total cost.finanzas_comparar_cuentasCompare savings and checking accounts.inmuebles_buscarSearch for apartments or houses for sale or rent via Ciencuadras.soulprint_statusCheck your score, DID, session, and reputation.trabajo_aplicarApply to jobs with verified identity (requires score >= 40).Environment Variables
SOULPRINT_TOKENToken for verified identity and premium service access.Configuration
claude_desktop_config.json
{"mcpServers": {"mcp-colombia": {"command": "npx", "args": ["-y", "mcp-colombia-hub"]}}}Try it
→Find me the best price for a hotel in Cartagena for next weekend.
→Compare the interest rates for CDTs across different Colombian banks.
→Search for 3-bedroom apartments for rent in Bogota using Ciencuadras.
→Simulate a loan for 50 million pesos over 36 months to see the total cost.
→Check my current Soulprint reputation score and status.