Analítica Empresarial — MCP Server

Servidor MCP (Model Context Protocol) que expone la API pública v1 de Analítica Empresarial como herramientas para modelos de IA compatibles con MCP (Claude Desktop, Cursor, Continue, Zed, etc.).

Herramientas disponibles

| Tool | Descripción | |------|-------------| | search_empresas | Buscar empresas por nombre o NIT (SIIS + SFC) | | get_empresa | Bundle SIIS: perfil + estados financieros + indicadores + benchmark | | get_empresa_financials | Estados financieros NIIF: ER, ESF, EFE | | get_empresa_indicators | 20 indicadores financieros por año y categoría | | get_empresa_benchmark | Percentiles P25/P50/P75 vs peers CIIU + ranking | | get_sfc_entity | Bundle SFC XBRL IFRS: bancos, aseguradoras, fondos | | screener_empresas | Listado paginado y filtrable de empresas SIIS |

Instalación

cd mcp-server
npm install
npm run build

Configuración en clientes MCP

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "analitica-empresarial": {
      "command": "node",
      "args": ["/ruta/absoluta/al/proyecto/mcp-server/dist/index.js"]
    }
  }
}

Cursor

En .cursor/mcp.json en la raíz del workspace o en ~/.cursor/mcp.json:

{
  "mcpServers": {
    "analitica-empresarial": {
      "command": "node",
      "args": ["/ruta/absoluta/al/proyecto/mcp-server/dist/index.js"]
    }
  }
}

Continue (VS Code)

En ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "node",
          "args": ["/ruta/absoluta/al/proyecto/mcp-server/dist/index.js"]
        }
      }
    ]
  }
}

Variables de entorno

| Variable | Default | Descripción | |----------|---------|-------------| | ANALITICA_API_URL | https://www.analiticaempresarial.info/api/v1 | URL base de la API (útil para desarrollo local) |

Ejemplo para apuntar a un entorno local:

{
  "mcpServers": {
    "analitica-empresarial": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "ANALITICA_API_URL": "http://localhost:3000/api/v1"
      }
    }
  }
}

Ejemplos de uso con Claude

Una vez configurado, puedes pedirle a Claude:

¿Cuáles son los indicadores de rentabilidad de Ecopetrol (NIT 899999068) en los últimos 3 años?

Lista las 20 empresas con más ingresos en el sector de manufactura de Antioquia.

Compara los márgenes de Bavaria vs su sector CIIU.

¿Cómo está el nivel de endeudamiento del Banco de Bogotá?

Desarrollo local

# Watch mode — recompila en cada cambio
npm run dev

# En otra terminal, prueba el servidor directamente
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

Límites de la API

• 60 req/min para endpoints empresa, search, screener
• 30 req/min para endpoints /sfc y /screener (más costosos)
• Timeout de 30 segundos por request
• CORS abierto — sin autenticación requerida
• Licencia de datos: CC BY 4.0 (citar fuente SIIS/SFC en análisis derivados)