Documentación pública

BencinaMCP API

BencinaMCP publica datos diarios del mercado chileno de combustibles de tres formas: como tablero web, como endpoints estáticos (JSON / RSS / Markdown) y como servidor MCP que cualquier asistente IA puede usar en lenguaje natural.

MCP server

URL: https://bencinachilemcp.kemenylabs.com/mcp
Auth: ninguna · Transporte: Streamable HTTP · 15 herramientas, 2 resources

Más detalle de cómo conectarte en la página principal (sección “Conecta BencinaMCP a tu IA en 30 segundos”). Los snippets JSON para Cursor y Claude Desktop están listos para copiar.

Tools registradas

Cada tool acepta argumentos opcionales (combustible, comuna, marca, etc.) y devuelve JSON estructurado. Todas son brand-agnostic — no hay sesgo hacia ningún operador.

  • overall_status()

    Score agregado, totales, HHI nacional, renta implícita, última actualización.

  • list_detectors()

    Los 12 detectores con score 0-100 y resumen.

  • national_concentration(fuel?)

    HHI / CR1 / CR4 / marca dominante a nivel país.

  • region_concentration(region?, fuel?)

    Concentración por región (una o todas).

  • lookup_comuna(comuna)

    Datos completos: HHI por combustible, estaciones, hallazgos.

  • search_comunas(query, fuel?, limit?)

    Búsqueda parcial por nombre de comuna o región.

  • local_monopolies(fuel?, min_hhi?, limit?)

    Comunas con HHI ≥ umbral y premium.

  • brand_profile(brand)

    Cuota, comunas dominadas, renta anual.

  • rent_extraction(fuel?)

    Renta total + por marca + por región.

  • top_findings(level?, limit?)

    Hallazgos CRITICAL/HIGH/MEDIUM/LOW.

  • compare_fuels()

    Concentración y renta para los 4 combustibles lado a lado.

  • border_discontinuities()

    Hallazgos del detector RDD en fronteras regionales.

  • daily_changes(fuel?)

    Mayores movimientos, coordinados, brand-wide.

  • find_focal_prices(fuel?)

    Puntos de precio donde convergen múltiples marcas.

  • latest_brief()

    Brief ejecutivo completo (Markdown).

Smoke test rápido

Inicializa una sesión y lista las tools:

curl -sN -X POST "https://bencinachilemcp.kemenylabs.com/mcp" \
  -H "Accept: application/json,text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2024-11-05",
                 "capabilities":{},
                 "clientInfo":{"name":"smoke","version":"1.0"}}}'

curl -sN -X POST "https://bencinachilemcp.kemenylabs.com/mcp" \
  -H "Accept: application/json,text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Endpoints estáticos

Si solo quieres los datos en bruto (sin MCP), están publicados como archivos estáticos servidos desde el dashboard. Se actualizan a diario tras la corrida automática de las 08:00 hora Chile.

Forma de los datos

Una clave útil del bundle: fuels["1"] (Gasolina 93), "7" (Gasolina 95), "2" (Gasolina 97), "3" (Diesel). Cada slice trae national_concentration, market_concentration (top 20), all_concentration (todas las comunas), regional_concentration, local_monopolies, dominance_exposure, rent_extraction, focal_prices, identical_prices, daily_diff.

Top-level: report, stats, market_share, risk_history, comuna_stations, last_updated.

Definiciones TypeScript completas en dashboard/lib/data.ts.

Recursos del MCP

  • bencinamcp://bundle — bundle completo JSON.
  • bencinamcp://brief — brief ejecutivo Markdown.

Términos

Datos derivados de la API pública bencinaenlinea.cl de la CNE. BencinaMCP publica análisis sobre esos datos bajo licencia MIT (repo). Los hallazgos son indicios estadísticos, no pruebas judiciales; ver /sobre para limitaciones.