mcp-colombia
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 "Deploy 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-colombia Busca 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"
}
}
}
}Related MCP server: Scavio
🛠️ 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
Available Tools
8 toolsfinanzas_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP 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.61MIT
- AlicenseAqualityBmaintenanceAn 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.216,222 npm8MIT
- AlicenseNot gradedqualityCmaintenanceMCP tool server that gives any AI agent the ability to search, scrape, and analyze content across the internet.42MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that enables AI agents to search and compare products and generate Amazon affiliate purchase links.-