Referencia

Herramientas MCP disponibles.

Cada conector expone un conjunto de herramientas (tools) que la IA puede invocar. Esta es la lista completa para el conector de Ecuador.

Endpoint base

https://connector.alheli.ai/api/mcp

Protocolo: 2026-03-26
Transporte: Streamable HTTP
Auth: Bearer (OAuth 2.1 o API key)
Discovery: /.well-known/oauth-protected-resource

Developer API · Para integrar tu producto

Llamadas directas con API key.

Si construyes un backend, agente o app que necesita consultar la ley de LATAM, autentica con una API key sobre el mismo endpoint MCP. Empiezas con 10 consultas gratis cada mes calendario; después, $0.01 por llamada desde tu saldo prepagado (recarga mínima $5, no expira).

01
Crea una API key
En /dashboard/api. La clave se muestra una sola vez.
02
Recarga saldo (opcional)
Las primeras 10 llamadas del mes son gratis. Luego $0.01 c/u con saldo prepagado.
03
Envía requests JSON-RPC
Mismo wire format que usan Claude / ChatGPT / Gemini.

Ejemplo · tools/list

curl -X POST https://connector.alheli.ai/api/mcp \
  -H "Authorization: Bearer alh_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ejemplo · tools/call · search_normativa

curl -X POST https://connector.alheli.ai/api/mcp \
  -H "Authorization: Bearer alh_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"ec_legislacion_search_normativa",
      "arguments":{"query":"prescripción extintiva en materia civil"}
    }
  }'

Cobro: sólo llamadas con status="ok" consumen saldo. Errores y fallas se reembolsan automáticamente.
Si tienes Pro/Estudio: las llamadas con API key cuentan contra tu cuota mensual, no contra el saldo.
Sin tarjeta: las 10 llamadas gratis no requieren método de pago registrado.
Revocación: en cualquier momento desde el panel. Hashes SHA-256 — nunca guardamos la clave en plano.

latamuniversal-search

Búsqueda LATAM unificada

Búsqueda y recuperación de fragmentos legales en todos los conectores LATAM activos. Tools `search` y `fetch` compatibles con la especificación de Apps en ChatGPT.

search

Busca artículos de normativa y sentencias de jurisprudencia oficiales de Latinoamérica en lenguaje natural. Devuelve resultados rankeados con un identificador opaco que puede usarse con la herramienta `fetch` para obtener el texto completo del fragmento.

Cuándo usar: Usa esta herramienta como punto de entrada cuando necesites encontrar fragmentos legales relevantes. Devuelve hasta 10 resultados unificados (normativa + jurisprudencia). Si necesitas el texto completo de un resultado, llama a `fetch` con su id.

fetch

Devuelve el texto completo y la metadata de un fragmento previamente obtenido con `search`. Recibe el id opaco entregado por search.

Cuándo usar: Llama a esta herramienta cuando ya hayas decidido cuál de los resultados de `search` necesita más detalle. Devuelve el texto completo del fragmento, la cita oficial (cuerpo normativo o número de causa) y la metadata relevante.

eclegislacion

Ecuador — Legislación y Jurisprudencia

Acceso a normativa vigente y jurisprudencia de Ecuador como contexto para asistentes de IA. Devuelve fragmentos rankeados (artículos / sentencias) con su metadata. No expone documentos completos.

ec_legislacion_search_normativa

Busca artículos relevantes de normativa ecuatoriana (Constitución, códigos, leyes, reglamentos, decretos) usando búsqueda semántica. Devuelve artículos rankeados con el título del cuerpo normativo al que pertenecen.

Cuándo usar: Usa esta herramienta cuando necesites fundamentar un argumento con texto normativo vigente del Ecuador. Devuelve únicamente artículos como fragmentos — no documentos completos. Para mejor precisión, formula consultas que incluyan la materia (penal, tributaria, laboral, etc.) y el supuesto fáctico relevante.

ec_legislacion_search_jurisprudencia

Busca sentencias relevantes de jurisprudencia ecuatoriana usando búsqueda semántica. Devuelve la decisión y un resumen, junto con número de causa, fecha, materia y tipo de acción.

Cuándo usar: Úsala para encontrar precedentes o ratio decidendi aplicable a un caso. Devuelve fragmentos (resumen + decisión) — no la sentencia completa. Combínala con `ec_legislacion_search_normativa` para fundamentar la posición legal con texto normativo y jurisprudencial.

Forma de la respuesta.

Cada llamada devuelve un bloque content de tipo texto, y un structuredContent con los chunks tipados.

search_normativa → chunks

• rank · posición
• score · distancia (menor = mejor)
• legislation_title · ej. "Código Orgánico Integral Penal"
• article_text · texto del artículo

search_jurisprudencia → chunks

• rank · posición
• score · distancia
• numero · ej. "0001-22-CC"
• fecha_decision · YYYY-MM-DD
• materia / tipo_accion
• resumen · síntesis
• decision · parte resolutiva