Plataforma de Datos · Acceso con clave

API & MCP de SISMO911

Construye sobre los datos sísmicos en vivo de Venezuela. Todo el acceso programático requiere registro, aprobación de un operador y una clave + secreto — tanto la API REST (/api/v1) como el servidor MCP. Regístrate una vez y usa la misma credencial en ambos.

1 · Regístrate

Solicita una clave → un operador aprueba → recibes clave + secreto (el secreto se muestra una vez).

Registrarme →

2 · API REST

Sismos, estadísticas y export en volumen desde nuestra DB. Con clave aprobada + scope.

Ver endpoints →

3 · Servidor MCP

Conecta agentes de IA. Herramientas de solo lectura — requieren la misma clave aprobada.

Configurar MCP →

Feed sísmico (requiere clave aprobada)

GET /api/v1/earthquakes

scope read:earthquakes — lista de sismos. Filtros: minMag, from, to, q, page, pageSize.

GET /api/v1/earthquakes/:id

scope read:earthquakes — un sismo por id.

GET /api/v1/latest

scope read:earthquakes — sismos recientes + nivel de amenaza actual.

GET /api/v1/stats

scope read:stats — estadísticas agregadas (total, mag máx, conteos 24h/7d/30d).

Abiertos sin clave solo: GET /api/v1 (esta documentación), POST /api/v1/register y GET /api/v1/me.

Ejemplo (con clave aprobada)

curl https://sismo911.com/api/v1/latest?limit=5 \
  -H "X-API-Key: sk911_xxxxxxxx" \
  -H "X-API-Secret: <tu_secreto>"

Servidor MCP (requiere clave aprobada)

Endpoint MCP (Streamable HTTP, JSON-RPC 2.0): https://sismo911.com/mcp. Solo lectura, con clave: tools/list y tools/call requieren tu clave aprobada vía Authorization: Bearer <key>:<secret> (cada herramienta exige su scope). initialize/ping quedan abiertos para el handshake. Herramientas: list_earthquakes, get_earthquake, latest_earthquakes, seismic_stats, list_shelters, list_news, search_missing_persons.

Claude Code / Desktop (mcp.json) — con cabecera de autorización

{
  "mcpServers": {
    "sismo911": {
      "type": "http",
      "url": "https://sismo911.com/mcp",
      "headers": { "Authorization": "Bearer sk911_xxxxxxxx:<tu_secreto>" }
    }
  }
}

CLI

claude mcp add --transport http sismo911 https://sismo911.com/mcp \
  --header "Authorization: Bearer sk911_xxxxxxxx:<tu_secreto>"

Nota: los conectores que solo aceptan una URL (sin cabeceras) no podrán autenticarse. Usa un cliente que permita enviar la cabecera Authorization.

3 · API con clave — Regístrate

Para extraer datos en volumen de nuestra base de datos (incluido el registro de personas desaparecidas, bajo permiso explícito), solicita una clave. Recibirás una API key y un secreto al instante (el secreto se muestra una sola vez); un operador revisará y aprobará tu solicitud antes de habilitar el acceso a /api/v1/data/*.

Endpoints con clave (requiere aprobación)

Autenticación — cabeceras o Bearer:

X-API-Key: sk911_xxxxxxxx
X-API-Secret: <tu_secreto>
# o bien
Authorization: Bearer sk911_xxxxxxxx:<tu_secreto>

GET /api/v1/me

Estado de tu clave (pendiente / aprobada) + permisos.

GET /api/v1/data/earthquakes

scope read:earthquakes — export paginado (hasta 200/página).

GET /api/v1/data/shelters

scope read:shelters — albergues aprobados.

GET /api/v1/data/blog

scope read:blog — noticias publicadas.

GET /api/v1/data/stats

scope read:stats — estadísticas.

GET /api/v1/data/missing-persons

scope read:missing-persons — registro de desaparecidos (otorgado por un operador, sin datos de contacto).

Ejemplo de extracción

curl https://sismo911.com/api/v1/data/earthquakes?minMag=4&pageSize=200 \
  -H "X-API-Key: sk911_xxxxxxxx" \
  -H "X-API-Secret: <tu_secreto>"

Datos sísmicos por USGS. Personas desaparecidas y albergues son aportados por la ciudadanía (solo registros moderados/aprobados). Úsalos de forma responsable.