{"_id":"@analitica-empresarial/mcp-server","name":"@analitica-empresarial/mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@analitica-empresarial/mcp-server","version":"1.0.0","description":"MCP Server for the Analítica Empresarial public API — financial data for 35k+ Colombian companies","type":"module","main":"dist/index.js","bin":{"analitica-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.5.0"},"engines":{"node":">=18.0.0"},"keywords":["mcp","colombia","financial-data","empresas-colombianas","supersociedades","superfinanciera"],"license":"MIT","gitHead":"d42f9059ef5411260f1736f03ebcc1df730f65f0","types":"./dist/index.d.ts","_id":"@analitica-empresarial/mcp-server@1.0.0","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-ReQXAcFMf5YZ9KZTI0VBxZnWxC30/DURew7u+scjtfuoOJC2t1amYvlTT2gOMGW9iKFGIdYpeMIq/FKZ2UBuwg==","shasum":"16affc600b699d2b1071b7e8a55034afa8493a8a","tarball":"https://registry.npmjs.org/@analitica-empresarial/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":6,"unpackedSize":27823,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDOlvUCK5YPDIdHpRMuqv145faUleYfeHOUm3h4Hth4ygIgbZokBMQQcoy5IkfWjI6Xux1BRUsqStya/+3K7nO75Qw="}]},"_npmUser":{"name":"jorgeortega618","email":"jorgeortega618@gmail.com"},"directories":{},"maintainers":[{"name":"jorgeortega618","email":"jorgeortega618@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.0_1780367194585_0.5201540580565374"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T02:26:34.346Z","1.0.0":"2026-06-02T02:26:34.719Z","modified":"2026-06-02T02:26:34.991Z"},"maintainers":[{"name":"jorgeortega618","email":"jorgeortega618@gmail.com"}],"description":"MCP Server for the Analítica Empresarial public API — financial data for 35k+ Colombian companies","keywords":["mcp","colombia","financial-data","empresas-colombianas","supersociedades","superfinanciera"],"license":"MIT","readme":"# Analítica Empresarial — MCP Server\n\nServidor MCP (Model Context Protocol) que expone la [API pública v1](https://www.analiticaempresarial.info/api/v1) de Analítica Empresarial como herramientas para modelos de IA compatibles con MCP (Claude Desktop, Cursor, Continue, Zed, etc.).\n\n## Herramientas disponibles\n\n| Tool | Descripción |\n|------|-------------|\n| `search_empresas` | Buscar empresas por nombre o NIT (SIIS + SFC) |\n| `get_empresa` | Bundle SIIS: perfil + estados financieros + indicadores + benchmark |\n| `get_empresa_financials` | Estados financieros NIIF: ER, ESF, EFE |\n| `get_empresa_indicators` | 20 indicadores financieros por año y categoría |\n| `get_empresa_benchmark` | Percentiles P25/P50/P75 vs peers CIIU + ranking |\n| `get_sfc_entity` | Bundle SFC XBRL IFRS: bancos, aseguradoras, fondos |\n| `screener_empresas` | Listado paginado y filtrable de empresas SIIS |\n\n## Instalación\n\n```bash\ncd mcp-server\nnpm install\nnpm run build\n```\n\n## Configuración en clientes MCP\n\n### Claude Desktop\n\nEdita `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"analitica-empresarial\": {\n      \"command\": \"node\",\n      \"args\": [\"/ruta/absoluta/al/proyecto/mcp-server/dist/index.js\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nEn `.cursor/mcp.json` en la raíz del workspace o en `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"analitica-empresarial\": {\n      \"command\": \"node\",\n      \"args\": [\"/ruta/absoluta/al/proyecto/mcp-server/dist/index.js\"]\n    }\n  }\n}\n```\n\n### Continue (VS Code)\n\nEn `~/.continue/config.json`:\n\n```json\n{\n  \"experimental\": {\n    \"modelContextProtocolServers\": [\n      {\n        \"transport\": {\n          \"type\": \"stdio\",\n          \"command\": \"node\",\n          \"args\": [\"/ruta/absoluta/al/proyecto/mcp-server/dist/index.js\"]\n        }\n      }\n    ]\n  }\n}\n```\n\n## Variables de entorno\n\n| Variable | Default | Descripción |\n|----------|---------|-------------|\n| `ANALITICA_API_URL` | `https://www.analiticaempresarial.info/api/v1` | URL base de la API (útil para desarrollo local) |\n\nEjemplo para apuntar a un entorno local:\n\n```json\n{\n  \"mcpServers\": {\n    \"analitica-empresarial\": {\n      \"command\": \"node\",\n      \"args\": [\"dist/index.js\"],\n      \"env\": {\n        \"ANALITICA_API_URL\": \"http://localhost:3000/api/v1\"\n      }\n    }\n  }\n}\n```\n\n## Ejemplos de uso con Claude\n\nUna vez configurado, puedes pedirle a Claude:\n\n```\n¿Cuáles son los indicadores de rentabilidad de Ecopetrol (NIT 899999068) en los últimos 3 años?\n\nLista las 20 empresas con más ingresos en el sector de manufactura de Antioquia.\n\nCompara los márgenes de Bavaria vs su sector CIIU.\n\n¿Cómo está el nivel de endeudamiento del Banco de Bogotá?\n```\n\n## Desarrollo local\n\n```bash\n# Watch mode — recompila en cada cambio\nnpm run dev\n\n# En otra terminal, prueba el servidor directamente\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node dist/index.js\n```\n\n## Límites de la API\n\n- **60 req/min** para endpoints empresa, search, screener\n- **30 req/min** para endpoints `/sfc` y `/screener` (más costosos)\n- Timeout de 30 segundos por request\n- CORS abierto — sin autenticación requerida\n- Licencia de datos: CC BY 4.0 (citar fuente SIIS/SFC en análisis derivados)\n","readmeFilename":"README.md","_rev":"1-ff6f28b2002c005b2cfe285ac54e1846"}