Skip to main content
Glama
Colombia MCP Server

Colombia MCP Server

by crexative

🇨🇴 Colombia MCP Server

NPM Version License: MIT

Un servidor MCP (Model Context Protocol) para consultar información geográfica, turística, histórica y cultural de Colombia.

📋 Características

  • 15 herramientas para consultar datos de Colombia

  • Regiones: Las 6 regiones naturales

  • Departamentos: 32 departamentos + Bogotá D.C.

  • Ciudades: Municipios por departamento

  • Turismo: Atracciones turísticas con coordenadas e imágenes

  • Historia: Presidentes de Colombia

  • Infraestructura: Aeropuertos y emisoras de radio

  • Naturaleza: Áreas naturales protegidas y resguardos indígenas

  • Mapas: Mapas de departamentos

Related MCP server: rues

🚀 Instalación

Para Claude Desktop

Agrega lo siguiente a tu archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}

Para Cursor

Agrega a .cursor/mcp.json en tu proyecto:

{
  "mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}

Para Windsurf

Agrega a ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}

Para Claude Code (CLI)

Agrega a ~/.claude/settings.json:

{
  "mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}

Para Cline (VS Code)

En VS Code Settings (JSON):

{
  "cline.mcpServers": {
    "colombia": {
      "command": "npx",
      "args": ["@crexative/colombia-mcp-server"]
    }
  }
}

🛠️ Herramientas Disponibles (15)

📍 Geografía

Herramienta

Descripción

Parámetros

get_regions

Obtiene las 6 regiones naturales de Colombia

-

get_departments

Lista los 32 departamentos + Bogotá D.C.

-

get_department

Información detallada de un departamento

id o name

get_departments_by_region

Departamentos de una región específica

region_id (1-6)

get_cities

Ciudades/municipios de un departamento

department_id

🏖️ Turismo

Herramienta

Descripción

Parámetros

get_tourist_attractions

Atracciones turísticas con coordenadas e imágenes

city_id o search

get_natural_areas

Áreas naturales protegidas (parques, reservas)

department_id (opcional)

get_maps

Mapas de departamentos

department_id (opcional)

🏛️ Historia y Gobierno

Herramienta

Descripción

Parámetros

get_country_info

Información general de Colombia (bandera, himno, símbolos)

-

get_presidents

Lista de todos los presidentes de Colombia

-

get_president

Información detallada de un presidente

id

🏗️ Infraestructura

Herramienta

Descripción

Parámetros

get_airports

Aeropuertos con códigos IATA/OACI

department_id (opcional)

get_radios

Emisoras de radio con frecuencia y streaming

city_id (opcional)

🌿 Cultura y Naturaleza

Herramienta

Descripción

Parámetros

get_indigenous_reservations

Resguardos indígenas

department_id (opcional)

search_colombia

Búsqueda general de información

query


🗺️ IDs de Regiones

ID

Región

1

Caribe

2

Pacífico

3

Orinoquía

4

Amazonía

5

Andina

6

Insular


📝 Ejemplos de Uso

Geografía

Usuario: ¿Cuáles son las regiones de Colombia?
Claude: [Usa get_regions]

Usuario: Dame información sobre Antioquia
Claude: [Usa get_department con name="Antioquia"]

Usuario: ¿Qué departamentos están en la región Caribe?
Claude: [Usa get_departments_by_region con region_id=1]

Usuario: ¿Qué ciudades hay en el Valle del Cauca?
Claude: [Usa get_cities con department_id=31]

Turismo

Usuario: ¿Qué lugares turísticos hay en Cartagena?
Claude: [Usa get_tourist_attractions con search="Cartagena"]

Usuario: Busca playas en Colombia
Claude: [Usa get_tourist_attractions con search="playa"]

Usuario: ¿Cuáles son los parques naturales del Amazonas?
Claude: [Usa get_natural_areas con department_id=1]

Historia

Usuario: ¿Quiénes han sido los presidentes de Colombia?
Claude: [Usa get_presidents]

Usuario: Dame información sobre el presidente con ID 10
Claude: [Usa get_president con id=10]

Infraestructura

Usuario: ¿Cuáles son los aeropuertos de Colombia?
Claude: [Usa get_airports]

Usuario: Aeropuertos en Antioquia
Claude: [Usa get_airports con department_id=2]

Usuario: ¿Qué emisoras de radio hay en Bogotá?
Claude: [Usa get_radios con city_id=167]

Información General

Usuario: ¿Cuál es la capital de Colombia?
Claude: [Usa get_country_info]

Usuario: ¿Cuáles son los símbolos patrios de Colombia?
Claude: [Usa get_country_info]

Usuario: ¿Qué resguardos indígenas hay en el Cauca?
Claude: [Usa get_indigenous_reservations con department_id=11]

🔧 Desarrollo Local

# Clonar el repositorio
git clone https://github.com/crexative/colombia-mcp-server.git
cd colombia-mcp-server

# Instalar dependencias
npm install

# Compilar
npm run build

# Ejecutar
npm start

🌐 API Utilizada

Este MCP utiliza la API Colombia para obtener datos actualizados sobre:

  • Información del país

  • Regiones naturales

  • Departamentos y ciudades

  • Presidentes

  • Aeropuertos

  • Emisoras de radio

  • Atracciones turísticas

  • Áreas naturales protegidas

  • Resguardos indígenas

  • Mapas


📄 Licencia

MIT License - ver LICENSE para más detalles.


🤝 Contribuciones

¡Las contribuciones son bienvenidas! Por favor, abre un issue o pull request.


📧 Contacto


🇨🇴 Hecho con ❤️ para Colombia

Available Tools

15 tools
get_airportsObtener Aeropuertos de ColombiaA
Read-onlyIdempotent

Obtiene la lista de aeropuertos de Colombia. Puede filtrar por departamento.

Args:

  • department_id (number, opcional): ID del departamento para filtrar

Returns: Lista de aeropuertos con nombre, ciudad, tipo y códigos IATA/OACI.

Ejemplo de uso:

  • "¿Cuáles son los aeropuertos de Colombia?"

  • "Aeropuertos en Antioquia"

Inputs: department_id.

get_citiesObtener Ciudades de un DepartamentoA
Read-onlyIdempotent

Obtiene todas las ciudades/municipios de un departamento específico.

Args:

  • department_id (number): ID del departamento

Returns: Lista de ciudades con nombre, población y código postal.

Ejemplo de uso:

  • "¿Qué ciudades hay en Antioquia?"

  • "Lista los municipios del Valle del Cauca"

Inputs: department_id (required).

get_country_infoObtener Información de ColombiaA
Read-onlyIdempotent

Obtiene información general sobre Colombia como país.

Returns: Información del país incluyendo nombre, capital, bandera, moneda, etc.

Ejemplo de uso:

  • "¿Cuál es la capital de Colombia?"

  • "Dame información general de Colombia"

Inputs: no named parameters.

get_departmentObtener Departamento EspecíficoA
Read-onlyIdempotent

Obtiene información detallada de un departamento específico por ID o nombre.

Args:

  • id (number, opcional): ID del departamento (1-33)

  • name (string, opcional): Nombre del departamento (ej: "Antioquia", "Cundinamarca")

Returns: Información detallada del departamento incluyendo población, superficie, capital y descripción.

Ejemplo de uso:

  • "Dame información sobre Antioquia"

  • "¿Cuál es la capital de Cundinamarca?"

Inputs: id, name.

get_departmentsObtener Departamentos de ColombiaA
Read-onlyIdempotent

Obtiene los 32 departamentos de Colombia más Bogotá D.C.

Returns: Lista de departamentos con: id, nombre, capital, población, superficie y región.

Ejemplo de uso:

  • "¿Cuáles son los departamentos de Colombia?"

  • "Lista todos los departamentos"

Inputs: no named parameters.

get_departments_by_regionObtener Departamentos por RegiónA
Read-onlyIdempotent

Obtiene todos los departamentos que pertenecen a una región específica.

Args:

  • region_id (number): ID de la región

    • 1 = Caribe

    • 2 = Pacífico

    • 3 = Orinoquía

    • 4 = Amazonía

    • 5 = Andina

    • 6 = Insular

Returns: Lista de departamentos de esa región.

Ejemplo de uso:

  • "¿Cuáles departamentos están en la región Caribe?"

  • "Dame los departamentos de la Amazonía"

Inputs: region_id (required).

get_indigenous_reservationsObtener Resguardos IndígenasA
Read-onlyIdempotent

Obtiene la lista de resguardos indígenas de Colombia. Puede filtrar por departamento.

Args:

  • department_id (number, opcional): ID del departamento para filtrar

Returns: Lista de resguardos indígenas con nombre, comunidad y departamento.

Ejemplo de uso:

  • "¿Cuáles son los resguardos indígenas de Colombia?"

  • "Resguardos indígenas en el Cauca"

Inputs: department_id.

get_mapsObtener MapasA
Read-onlyIdempotent

Obtiene mapas de Colombia o de un departamento específico.

Args:

  • department_id (number, opcional): ID del departamento para obtener su mapa

Returns: URLs de mapas del departamento o país.

Ejemplo de uso:

  • "Dame el mapa de Antioquia"

  • "Quiero ver mapas de Colombia"

Inputs: department_id.

get_natural_areasObtener Áreas Naturales ProtegidasA
Read-onlyIdempotent

Obtiene la lista de áreas naturales protegidas de Colombia. Puede filtrar por departamento.

Args:

  • department_id (number, opcional): ID del departamento para filtrar

Returns: Lista de áreas naturales con nombre, categoría y departamento.

Ejemplo de uso:

  • "¿Cuáles son los parques naturales de Colombia?"

  • "Áreas naturales en el Amazonas"

Inputs: department_id.

get_presidentObtener Presidente EspecíficoB
Read-onlyIdempotent

Obtiene información detallada de un presidente específico.

Args:

  • id (number): ID del presidente

Returns: Información detallada del presidente.

Ejemplo de uso:

  • "Dame información sobre el presidente con ID 5"

Inputs: id (required).

get_presidentsObtener Presidentes de ColombiaA
Read-onlyIdempotent

Obtiene la lista de presidentes de Colombia.

Returns: Lista de presidentes con nombre, período, partido político y ciudad de nacimiento.

Ejemplo de uso:

  • "¿Quiénes han sido los presidentes de Colombia?"

  • "Lista de presidentes colombianos"

Inputs: no named parameters.

get_radiosObtener Emisoras de RadioA
Read-onlyIdempotent

Obtiene la lista de emisoras de radio de Colombia. Puede filtrar por ciudad.

Args:

  • city_id (number, opcional): ID de la ciudad para filtrar

Returns: Lista de emisoras con nombre, frecuencia, ciudad y URL de streaming.

Ejemplo de uso:

  • "¿Qué emisoras de radio hay en Colombia?"

  • "Emisoras de radio en Bogotá"

Inputs: city_id.

get_regionsObtener Regiones de ColombiaA
Read-onlyIdempotent

Obtiene las 6 regiones naturales de Colombia: Caribe, Pacífico, Orinoquía, Amazonía, Andina e Insular.

Returns: Lista de regiones con id, nombre y descripción.

Ejemplo de uso:

  • "¿Cuáles son las regiones de Colombia?"

  • "Dame información sobre las regiones naturales"

Inputs: no named parameters.

get_tourist_attractionsObtener Atracciones TurísticasA
Read-onlyIdempotent

Obtiene atracciones turísticas de Colombia. Puedes buscar por ciudad o por palabra clave.

Args:

  • city_id (number, opcional): ID de la ciudad para filtrar

  • search (string, opcional): Palabra clave para buscar (ej: "playa", "museo", "parque")

Returns: Lista de atracciones con nombre, descripción, ubicación e imágenes.

Ejemplo de uso:

  • "¿Qué lugares turísticos hay en Cartagena?"

  • "Busca atracciones relacionadas con playas"

Inputs: city_id, search.

search_colombiaBuscar en ColombiaB
Read-onlyIdempotent

Herramienta de búsqueda general que intenta encontrar información sobre departamentos, ciudades o lugares turísticos.

Args:

  • query (string): Término de búsqueda (nombre de departamento, ciudad o lugar)

Returns: Resultados de búsqueda con la información encontrada.

Ejemplo de uso:

  • "Busca Medellín"

  • "Información sobre el Parque Tayrona"

Inputs: query (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 15 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific Colombian data categories like airports, cities, departments, regions, natural areas, indigenous reservations, radios, presidents, tourist attractions, and maps. However, there is some overlap between get_department and search_colombia, as both can retrieve department information, which might cause minor confusion. The descriptions help clarify, but the boundaries are not perfectly sharp.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, such as get_airports, get_cities, get_department, get_departments_by_region, get_indigenous_reservations, get_natural_areas, get_president, get_presidents, get_radios, get_regions, get_tourist_attractions, and search_colombia. This uniformity makes the tool set predictable and easy to understand, with no deviations in naming conventions.

    Tool Count5/5

    With 15 tools, the server is well-scoped for providing comprehensive information about Colombia, covering geography, culture, history, and tourism. Each tool serves a specific and relevant function, such as retrieving airports, cities, departments, regions, natural areas, indigenous reservations, radios, presidents, tourist attractions, maps, and a general search. The count is appropriate for the domain, avoiding both thinness and bloat.

    Completeness4/5

    The tool set offers broad coverage of Colombian data, including CRUD-like retrieval for various entities like departments, cities, regions, airports, natural areas, indigenous reservations, radios, presidents, and tourist attractions. Minor gaps exist, such as no update or delete operations (which may be intentional for a read-only informational server) and limited filtering options in some tools, but agents can work around these with the available search and filtering capabilities. The surface is largely complete for querying Colombian information.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides comprehensive information about Colombia including departments, regions, cities, tourist attractions, and general country data through the API Colombia service. Enables users to query Colombian geographical and administrative information through natural language.
      4
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying the Colombian Business Registry (RUES) for company searches by name, location grouping, and detailed company information.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that lets AI assistants query official Colombian department data (capital, population, area, municipalities, and phone prefix) in real time through the public Colombia REST API.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to look up Colombian company registry, sanctions, restricted-party lists, and public procurement records — including contracts, bidders, consortia, and process documents — all cross-referenced by NIT and returned with the official source and capture date behind every figure.
      MIT