# Energética MCP Server — documentación para LLMs > Versión markdown consolidada de la documentación del servidor MCP. > Fuente canónica: https://energetica.ar/mcp/docs — esta versión está pensada para alimentar > a un LLM como contexto. ## Qué es Energética expone datos del sector Oil & Gas argentino a través del Model Context Protocol (MCP). Cualquier agente compatible con MCP — Claude Desktop, Cursor, clientes custom, etc. — puede conectarse al endpoint y consultar producción mensual, pozos, precios, inversiones, balanza comercial, electricidad, macro y más. Los datos se obtienen de fuentes oficiales argentinas e internacionales, se normalizan y se consolidan en un único esquema DuckDB. El pipeline corre una vez por día. Endpoint: `https://energetica.ar/api/mcp` (transporte Streamable HTTP). ## Cómo conectarse Durante la fase beta el servidor está abierto **sin autenticación**. Apuntá tu cliente al endpoint: ```json { "mcpServers": { "energetica": { "url": "https://energetica.ar/api/mcp" } } } ``` Funciona igual desde Claude Desktop, Cursor o cualquier cliente MCP sobre Streamable HTTP. ## Límites durante la beta Rate limits por IP para proteger el servicio: - **200 requests/día** sobre las herramientas curadas (`query_*`, `get_schema`, `get_data_freshness`). - **40 requests/día** sobre `execute_sql`. - Al superar el límite: HTTP 429 con código JSON-RPC `-32029`. Al cerrar la beta vamos a introducir tiers pagos (Analyst, Professional, Enterprise) con límites mayores, SLA y soporte. Los usuarios activos durante la beta tienen prioridad. Para cupo extendido, casos de uso críticos o integraciones coordinadas, escribinos a . ## Herramientas disponibles (8 tools) ### Queries curadas #### `query_production` Producción mensual de petróleo, gas y agua (~18M registros). No requiere JOIN: cuenca, empresa, formación, provincia y área de concesión están denormalizadas en la tabla. Parámetros: `cuenca`, `empresa`, `formacion`, `fecha_desde` (YYYY-MM), `fecha_hasta` (YYYY-MM), `agrupar_por` (mes | anio | cuenca | empresa | formacion), `recurso` (petroleo | gas | agua | todos). Devuelve: `fecha, prod_petroleo_m3, prod_gas_miles_m3, prod_agua_m3, pozos_activos`. #### `query_wells` Búsqueda sobre ~50.000 pozos argentinos con ubicación, tipo, estado, profundidad y producción acumulada. Parámetros: `empresa`, `cuenca`, `provincia`, `tipo_recurso` (PETROLEO | GAS | AMBOS), `tipo_estado`, `formacion`, `con_produccion` (bool), `limit` (1-1000, default 100). Devuelve: `idpozo, sigla, nombre_propio, empresa, provincia, cuenca, area_concesion, formacion, tipo_pozo, tipo_estado, latitud, longitud, profundidad, petroleo_acumulado_m3, gas_acumulado_miles_m3, fecha_primera_prod`. #### `query_prices` Precios benchmark internacionales, crudo local argentino y tipos de cambio. Parámetros: `serie` (requerido — WTI | BRENT | HENRY_HUB | ESCALANTE | MEDANITO | USD_OFICIAL | USD_BLUE | USD_MEP | USD_CCL), `fecha_desde`, `fecha_hasta`, `frecuencia` (diario | mensual | anual). #### `query_investments` Inversiones upstream en Argentina por empresa, cuenca, año y concepto (MMUSD). Parámetros: `empresa`, `cuenca`, `anio_desde`, `anio_hasta`, `concepto` (perforacion, terminacion, infraestructura, etc.). #### `query_trade` Balance comercial de hidrocarburos — exportaciones e importaciones. Parámetros: `anio`, `flow` (export | import), `producto` (crude HS 2709 | refined HS 2710 | gas HS 2711). ### Discovery #### `get_schema` Nombres de tablas, columnas, tipos, descripciones, unidades, ejemplos. Llamada por primera vez (cache 1h). Parámetros: `tabla` (opcional). #### `get_data_freshness` Rango de fechas y conteo de filas por tabla. Sin parámetros. Cache 1h. ### SQL abierto #### `execute_sql` SQL de lectura arbitrario. **Abierto durante la beta** con rate limit de 40 requests/día por IP. Validaciones: - Rechaza DDL/DML (DROP, ALTER, INSERT, UPDATE, DELETE, CREATE, GRANT, REVOKE). - Bloquea patrones peligrosos (UNION, INFORMATION_SCHEMA, SLEEP, BENCHMARK, LOAD_FILE). - Restringido al listado de tablas del catálogo. - Timeout de 30 segundos por query. - Inyecta `LIMIT` automáticamente si falta. ## Tips para el LLM - Arrancá con `get_data_freshness` si no sabés cuán reciente es el dato. - Usá `get_schema` cuando necesites saber qué columnas existen en una tabla. - Especificá siempre rangos de fechas — sin filtros, las consultas suelen topar el límite de filas en tablas de millones de registros. - Los nombres de cuencas y provincias van en MAYÚSCULAS (NEUQUINA, GOLFO SAN JORGE, NEUQUEN, CHUBUT). - Unidades esperadas: producción en m³ y miles m³, precios en USD/bbl, inversiones en MMUSD, comercio en USD FOB. ## Catálogo de datos (resumen) Aproximadamente 40 tablas organizadas por dominio: - **Producción y pozos**: `produccion_mensual`, `pozos`, `fracturas`, `perforaciones`, `trayectorias_pozo`. - **Precios**: `precios_intl`, `precios_crudo_local`, `precios_gas_local`, `precios_combustibles`, `precios_benchmark`, `tipo_cambio`. - **Comercio, reservas, inversiones, refinación**: `balanza_comercial`, `inversiones_upstream`, `reservas`, `refinacion`, `ventas_subproductos`. - **Electricidad y gas**: `cammesa_demanda`, `cammesa_generacion`, `cammesa_consumo_gas`, `cammesa_precio_spot`, `cammesa_agentes_mem`, `cammesa_fallas_sadi`, `enargas_operativos`. - **Macro y finanzas**: `bcra_variables`, `acciones_energia`, `corporate_financials`. - **Contexto global**: `energia_mundial`, `commodities_worldbank`, `eia_extended`, `emisiones_oilgas`, `series_tiempo`, `google_trends`. - **Clima y geografía**: `temperatura_diaria`, `degree_days_diaria`, `neuquen_areas`, `balance_energetico`, `cammesa_publicaciones_ckan`. Ver el catálogo en vivo con rango de fechas y conteos: . ## Ejemplos reales **1. Producción de Vaca Muerta** Prompt: "Mostrame la producción de petróleo y gas de Vaca Muerta por año desde 2018." Tool: `query_production` con `formacion: "VACA MUERTA"`, `fecha_desde: "2018-01"`, `agrupar_por: "anio"`. **2. Top pozos por empresa** Prompt: "Top 10 pozos de YPF en Neuquén por producción acumulada de petróleo." Tool: `query_wells` con `empresa: "YPF"`, `provincia: "NEUQUEN"`, `limit: 10`. **3. WTI mensual 2024** Prompt: "¿Cuál fue el promedio mensual del WTI en 2024?" Tool: `query_prices` con `serie: "WTI"`, `fecha_desde: "2024-01-01"`, `fecha_hasta: "2024-12-31"`, `frecuencia: "mensual"`. **4. Inversión en cuenca Neuquina** Prompt: "¿Cuánto invirtieron los operadores en perforación en la cuenca Neuquina desde 2020?" Tool: `query_investments` con `cuenca: "NEUQUINA"`, `concepto: "perforacion"`, `anio_desde: 2020`. **5. Exportaciones de crudo 2024** Prompt: "Exportaciones argentinas de crudo en 2024." Tool: `query_trade` con `anio: 2024`, `flow: "export"`, `producto: "crude"`. **6. SQL custom** Prompt: "Para cada cuenca, ¿cuál es el ratio de pozos horizontales vs verticales perforados en 2024?" Tool: `execute_sql` con una consulta tipo: ```sql SELECT cuenca, COUNT(*) FILTER (WHERE tipo_pozo ILIKE '%horizontal%') AS horizontales, COUNT(*) FILTER (WHERE tipo_pozo ILIKE '%vertical%') AS verticales FROM pozos WHERE EXTRACT(YEAR FROM fecha_primera_prod) = 2024 GROUP BY cuenca ORDER BY horizontales DESC; ``` ## Recursos - Overview: - Introducción: - Referencia de tools: - Catálogo de datos: - Ejemplos: - Contacto: