---
name: meteor-api
description: Construir sobre Meteor: ejecutar agentes de IA (Mets), CRM y WhatsApp, tareas, datos y automatizaciones, por API REST, SDK o MCP.
---

# Meteor para agentes que codifican

Meteor es infraestructura agéntica como servicio: agentes de IA (**Mets**) que se
ejecutan por API, con CRM y canales de WhatsApp, colecciones de datos, tareas
ejecutables, webhooks y automatizaciones — todo detrás de una sola API.

Este pack te dice **cómo usarla bien**. Las herramientas te las da el servidor MCP;
lo que hay aquí es qué llamar en qué orden, qué límite tiene cada respuesta y qué
decide el servidor por ti.

## Las dos formas de entrar

**Servidor MCP** — el catálogo de 34 herramientas `met_*`, sobre
streamable-http:

    https://api.met.meteor.com.co/api/v1/mcp

Acepta **POST**. Autenticación con una API key `met_` en `Authorization: Bearer`.

**API REST y SDK** — para lo que el MCP no cubre. El SDK de TypeScript es
`@meteor.ia/sdk`; también hay uno de Python y un CLI (`@meteor.ia/cli`).

    npm i @meteor.ia/sdk

## Lo primero que hay que entender

**El catálogo se filtra por los scopes de tu key.** Una herramienta cuyo scope no
tienes **no aparece**, y eso es indistinguible de una herramienta que no existe. Si
buscas una y no está, revisa la key antes que la documentación.

**La Energía se debita por ejecución.** Ejecutar un Met o correr una tarea cuesta;
listar y leer, no. Un bucle que ejecuta un Met por cada fila de una colección gasta
tantas veces como filas tenga.

## Sub-skills

- **`meteor-api-mets`** (`mets/SKILL.md`) — Correr un agente sobre un input, elegir cuál lo atiende, o ver qué herramientas tiene.
- **`meteor-api-crm`** (`crm/SKILL.md`) — Buscar o crear un contacto, mandarle un mensaje, callar al Met para que conteste una persona.
- **`meteor-api-tasks`** (`tasks/SKILL.md`) — Disparar un procedimiento repetible, seguir una corrida, aprobar o rechazar un paso.
- **`meteor-api-data`** (`data/SKILL.md`) — Leer o escribir los datos del negocio que el Met consulta al responder.
- **`meteor-api-automations`** (`automations/SKILL.md`) — Ejecutar pasos definidos de antemano, cuando no hace falta que un Met decida.
- **`meteor-api-templates`** (`templates/SKILL.md`) — Montar un workspace desde una plantilla ya armada en vez de configurarlo pieza por pieza.

## La documentación, en markdown

Todo el portal se sirve en texto plano para que lo leas sin HTML alrededor:

- Cualquier guía: cambia `.html` por `.md`, o pide `Accept: text/markdown` sobre
  la misma URL.
- El mapa del portal con las preguntas frecuentes: https://developers.meteor.com.co/llms.txt
- Las guías completas concatenadas: https://developers.meteor.com.co/llms-full.txt

## Recetas de punta a punta

- [Un agente que contesta WhatsApp](https://developers.meteor.com.co/guias/receta-whatsapp.md) — De un mensaje que entra por WhatsApp a una respuesta del Met, con tu lógica en el medio y el traspaso a una persona cuando hace falta.
- [Sincronizar tu sistema con colecciones](https://developers.meteor.com.co/guias/receta-sincronizar-datos.md) — Espeja un catálogo, un inventario o una lista de precios dentro de Meteor para que tus Mets lo consulten sin que programes un endpoint por cada consulta.
- [Recibir eventos firmados en tu backend](https://developers.meteor.com.co/guias/receta-webhooks-firmados.md) — Un endpoint que recibe los eventos de tu workspace, verifica la firma y sobrevive a los reintentos sin procesar nada dos veces.
- [Ejecutar un Met desde GitHub Actions](https://developers.meteor.com.co/guias/receta-github-actions.md) — Poner un Met dentro de tu pipeline — resumir un despliegue, revisar un cambio o correr una tarea— con el código de salida reflejando el resultado.
- [Mostrar un run en vivo en tu UI](https://developers.meteor.com.co/guias/receta-streaming.md) — Pasar el stream del Met desde tu backend hasta el navegador, palabra por palabra, sin exponer la key y sin perder el resultado si el stream se corta.
- [Una tarea que pide aprobación humana](https://developers.meteor.com.co/guias/receta-aprobacion-humana.md) — Dejar que un Met haga el trabajo y se detenga a pedir permiso antes del paso que no se puede deshacer, con la decisión entrando desde tu propio sistema.