AgentPixel

npx add-mcp 'https://agentpixel.io/mcp'

API de Pixel

Contrato público para crear una cuenta, instalar un píxel y leer contactos. Las mismas páginas son para agentes y para personas.

Cómo leer esto

• GET /docs.json es el catálogo completo: lecciones más cada ruta a continuación, cada una con su markdown.
• GET /docs/{slug}.md es una lección o la referencia del endpoint como markdown. GET /docs/{slug} es la misma página como HTML.
• GET /llms.txt es el mapa corto.
• GET /openapi.json es el esquema generado. Es más delgado que este catálogo. La interfaz del esquema es /swagger.

Host de API de producción: https://agentpixel.io. https://agentpixel.io y https://agentpermission.io son este mismo proceso.

Llamadas

• Los errores JSON son {"detail": "..."} y un estado HTTP.
• Un cuerpo JSON con la forma incorrecta es 400 {"detail": "invalid request"}. Los nombres de los campos no se enumeran.
• Envía content-type: application/json en un POST JSON.
• Las llamadas de registro usan el encabezado x-signup-token. El token dura una hora desde POST /v1/accounts y no se renueva.
• Las llamadas posteriores usan Authorization: Bearer <api_key>. La clave comienza con px_ y se devuelve una vez. prefix son sus primeros 12 caracteres.
• En GET /v1/whoami, una clave incorrecta es 401. En las rutas de píxel, contacto y configuración, una clave incorrecta es 403.
• Las horas en las respuestas están en UTC.

Lecciones

1. Registro: cuenta, correo electrónico, pago, clave API.
2. Configuración: píxel, fragmento, verificación de instalación.
3. Consentimiento: ventana emergente de permiso y recibos.
4. Contactos: extrae personas por día o por id.

Excluido

Las rutas de operador bajo /console, /api/admin y /v1/admin no están en este catálogo.

Una clave ilimitada puede llamar a Activar y Canal. Una clave de pago recibe 403 en esas dos. Este catálogo no dice cómo se emite esa clave.