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.

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 es operado por Kemeny Studio; el análisis publicado puede usarse libremente citando la fuente. Los hallazgos son indicios estadísticos, no pruebas judiciales; ver /sobre para limitaciones.