Skip to main content
Glama

🇨🇴 mcp-colombia-hub

MCP server que conecta cualquier agente de IA con servicios colombianos — con identidad verificada y reputación de comportamiento mediante Soulprint.

npm MCP Compatible Soulprint Verified Tests License: MIT


🚀 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"
      }
    }
  }
}

Related MCP server: Scavio

🛠️ 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
  ✅ 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 test

Variables 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

soulprint

Protocolo de identidad (7 paquetes npm)

mcp-colombia-hub

Primer servicio verificado del ecosistema


📄 Licencia

MIT — Felipe Arias · @manuelariasfz

Available Tools

8 tools
finanzas_comparar_cdtB

Compara los mejores CDTs (Certificados de Depósito a Término) disponibles en Colombia según monto y plazo. Muestra tasas, rendimiento real y links al banco.

Inputs: monto (required), plazo_dias (required), top.

finanzas_comparar_cuentasB

Compara cuentas de ahorros y billeteras digitales en Colombia. Muestra rendimiento, cuota de manejo y GMF.

Inputs: tipo.

finanzas_simular_creditoB

Simula un crédito de consumo o libre inversión en los principales bancos y fintechs de Colombia. Muestra cuota mensual, total a pagar y costo del crédito.

Inputs: monto (required), cuotas (required), proposito.

inmuebles_buscarA

Busca apartamentos y casas en arriendo o venta en Colombia. Busca en FincaRaíz y MetroCuadrado. Filtra por ciudad, precio, habitaciones y zona.

Inputs: ciudad (required), tipo (required), habitaciones, precio_max, +3 more.

ml_buscar_productosB

Busca productos en MercadoLibre Colombia. Devuelve precios, vendedor, envío gratis y link de compra.

Inputs: query (required), categoria, limit, precio_min, +2 more.

ml_detalle_productoB

Obtiene el detalle completo de un producto de MercadoLibre por su ID (ej: MCO123456789).

Inputs: item_id (required).

viajes_buscar_hotelB

Busca hoteles en ciudades colombianas para las fechas indicadas. Devuelve sugerencias y link directo a Booking.com.

Inputs: ciudad (required), checkin (required), checkout (required), adultos, +2 more.

viajes_buscar_vuelosB

Busca vuelos domésticos e internacionales desde/hacia Colombia. Devuelve links a Avianca, LATAM y Skyscanner.

Inputs: origen (required), destino (required), fecha (required), ida_vuelta, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific domains (finances, real estate, e-commerce, travel) with no overlap in functionality. For example, finanzas_comparar_cdt and finanzas_comparar_cuentas serve different financial comparison needs, while ml_buscar_productos and ml_detalle_producto handle distinct e-commerce tasks.

    Naming Consistency5/5

    All tools follow a consistent snake_case pattern with a clear domain_prefix_verb_noun structure (e.g., finanzas_comparar_cdt, inmuebles_buscar). This predictable naming convention makes it easy to understand each tool's purpose and category at a glance.

    Tool Count5/5

    With 8 tools, the server is well-scoped for its purpose as a Colombia-focused utility covering multiple domains (finance, real estate, e-commerce, travel). Each tool earns its place by addressing a specific, common use case without redundancy or excessive fragmentation.

    Completeness4/5

    The tool set provides solid coverage for key consumer domains in Colombia, with clear CRUD-like operations where applicable (e.g., search and detail for products, search for flights/hotels). Minor gaps exist, such as no tool for comparing flight or hotel options directly, but agents can work around this by using the provided search tools effectively.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP Server for accessing 36 Brazilian public data sources and 1 agent, enabling AI agents to query government data on economy, legislation, transparency, judiciary, elections, environment, health, and more.
      6
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server connecting AI agents to Google, YouTube, Amazon, Walmart, TikTok, and Reddit. 21 tools for web search, product lookup, video discovery, and social media analysis.
      21
      6,222 npm
      8
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP tool server that gives any AI agent the ability to search, scrape, and analyze content across the internet.
      42
      MIT