Docs

Referencia de herramientas

Cada herramienta del servidor MCP de Sypnia: para qué sirve, su entrada y una llamada de ejemplo con su resultado.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. health
  2. problems
  3. problem
  4. problem_prompt
  5. sessions
  6. session
  7. search
  8. performance
  9. uptime
  10. resolve_problem
  11. Recursos
  12. Prompts

Motor Nube El servidor MCP de Sypnia tiene diez herramientas. Nueve solo leen. Una escribe: resolve_problem. Las herramientas son las mismas en el servidor remoto de Sypnia Cloud, en el que sirve un motor alojado por ti y en el local @sypnia/mcp. Su contrato legible por máquinas es spec/mcp.json, en el repositorio de la documentación.

Tu cliente muestra las herramientas bajo el nombre del servidor, sypnia. Según el cliente se lee sypnia.problems, sypnia:problems o mcp__sypnia__problems. Es la misma herramienta.

HerramientaÚsala para¿Escribe?
healthPreguntar «¿qué está fallando en producción?»No
problemsListar problemasNo
problemTraer un problema con todo lo necesario para arreglarloNo
problem_promptTraer el prompt listo de un problema, como textoNo
sessionsListar las sesiones que un problema afectó, o las sesiones recientesNo
sessionLeer una sesión, evento por eventoNo
searchEncontrar un problema, sesión, persona, versión o página por textoNo
performanceVer páginas lentas, llamadas a la API lentas o que fallan, y qué empeoróNo
uptimeVer si la app respondeNo
resolve_problemMarcar un problema como resuelto después del arregloSí

Reglas que valen para todas:

  • Un proyecto. El token de API pertenece a un proyecto, así que ninguna herramienta recibe un proyecto.
  • Producción por defecto. Las herramientas que leen datos reciben environment; si lo omites es production.
  • Los resultados son JSON. Cada resultado llega como contenido estructurado y, para clientes que solo leen texto, como el mismo JSON en un bloque de texto. Los campos nulos o vacíos se omiten.
  • Tamaño. Un resultado tiene como máximo 60.000 caracteres. Una lista más larga se corta y lo dice en truncated.
  • Los errores vuelven como error de herramienta con el code y el message de la API, por ejemplo not_found: No problem with id or slug 'pay-buton' in project 'shop'.
  • Lo que un resultado nunca trae: lo que una persona escribió, grabaciones, capturas de página, llaves de ingesta ni tokens.

Los nombres de las herramientas, sus parámetros y los valores permitidos están en inglés y no se traducen. Las descripciones que el servidor le entrega al agente también están en inglés; aquí se explican en español.

health

MotorNube

Responde «¿qué está fallando en producción?» en una sola llamada. Devuelve el estado de la app ahora (failing, degraded u ok), los problemas abiertos que afectan a más personas, cada uno contado en una frase simple, las comprobaciones de disponibilidad caídas, las páginas que se pusieron lentas y qué tan frescos están los datos. El agente la llama primero cuando preguntas cómo va producción, si un despliegue rompió algo o qué arreglar después. Para arreglar uno de los problemas que devuelve, llama a problem con su slug.

Llama a: GET /v1/summary

Entrada

  • since
    string opcional

    Hasta dónde llega «ahora»: un número y una unidad (1h, 24h, 7d) o una fecha ISO 8601. De 1h a 7d.

    Por defecto: 24h

  • environment
    string opcional

    El entorno que se mira, por ejemplo production o development.

    Por defecto: production

Llamada

JSON
{
  "name": "health",
  "arguments": {}
}

Resultado

JSON
{
  "project": {
    "id": "prj_5k2m9x4q7w1z",
    "slug": "shop",
    "name": "Shop"
  },
  "environment": "production",
  "generated_at": "2026-03-12T10:35:00Z",
  "data_through": "2026-03-12T10:34:10Z",
  "state": "failing",
  "sentence": "1 new problem in the last 24 hours. Every uptime check is up. 1 page got slower.",
  "problems": {
    "open": 1,
    "new": 1,
    "regressed": 0,
    "top": [
      {
        "id": "prb_8f3k2m9x4q7w",
        "slug": "pay-button-does-nothing",
        "sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
        "title": "createPayment answered 400 in POST /api/checkout",
        "confidence": "high",
        "people": 3,
        "sessions": 3,
        "first_seen": "2026-03-12T09:12:04Z",
        "last_seen": "2026-03-12T10:31:47Z",
        "first_release": "4f2a91c",
        "regressed": false
      }
    ]
  },
  "uptime": {
    "checks": 1,
    "down": []
  },
  "performance": {
    "slower_pages": [
      {
        "route": "/search",
        "lcp_p75_ms": 3100,
        "previous_lcp_p75_ms": 1900,
        "views": 1840
      }
    ],
    "failing_api": []
  },
  "traffic": {
    "sessions": 498,
    "people": 412,
    "errors": 5
  },
  "alerts": {
    "unacknowledged": 1
  }
}

problems

MotorNube

Lista los problemas que Sypnia encontró en la app. Un problema es un grupo de fallas con una sola causa (un error, una llamada a la API que falla), con cuántas personas afectó y desde cuándo. Cada elemento trae una frase simple si Sypnia lo analizó (sentence), y si no su título técnico (title), más el lugar del código (where) y la confianza en la causa (confidence). Sirve para elegir en qué trabajar, para saber si una falla ya es conocida (q) o para ver qué rompió una versión (release). Por defecto devuelve los problemas abiertos, con la actividad más reciente primero. Para arreglar uno, llama a problem con su slug.

Llama a: GET /v1/problems

Entrada

  • status
    string opcional

    open: está pasando o nadie lo ha marcado como arreglado. resolved: marcado como arreglado. ignored: conocido y aceptado.

    Por defecto: open

  • q
    string, hasta 120 caracteres opcional

    Palabras que buscar en la frase, el título o el nombre del archivo, por ejemplo checkout o amount_required.

  • release
    string opcional

    Solo problemas vistos en esta versión (la versión de la app, normalmente un commit corto de git como 4f2a91c).

  • route
    string opcional

    Solo problemas en esta página o ruta de la API, por ejemplo /checkout o /api/orders/:id.

  • since
    string opcional

    Solo problemas vistos después de este momento: 24h, 7d o una fecha ISO 8601.

    Por defecto: 30d

  • sort
    string opcional

    people pone primero los problemas que afectaron a más personas. Uno de: last_seen, first_seen, people, occurrences.

    Por defecto: last_seen

  • environment
    string opcional

    El entorno que se mira.

    Por defecto: production

  • limit
    integer, 1 a 50 opcional

    Cuántos problemas devolver.

    Por defecto: 10

  • cursor
    string opcional

    El next_cursor de la llamada anterior, para traer la página siguiente.

Llamada

JSON
{
  "name": "problems",
  "arguments": {
    "status": "open"
  }
}

Resultado

JSON
{
  "problems": [
    {
      "id": "prb_8f3k2m9x4q7w",
      "slug": "pay-button-does-nothing",
      "status": "open",
      "regressed": false,
      "sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
      "title": "createPayment answered 400 in POST /api/checkout",
      "confidence": "high",
      "where": {
        "file": "src/checkout/checkout.tsx",
        "line": 142,
        "function": "confirmPayment"
      },
      "route": "/checkout",
      "people": 3,
      "sessions": 3,
      "occurrences": 5,
      "first_seen": "2026-03-12T09:12:04Z",
      "last_seen": "2026-03-12T10:31:47Z",
      "first_release": "4f2a91c",
      "url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing"
    }
  ],
  "counts": {
    "open": 1,
    "resolved": 4,
    "ignored": 1
  },
  "next_cursor": null
}

problem

MotorNube

Trae un problema con todo su contexto para arreglarlo. El agente la llama antes de cambiar código. Devuelve: analysis (qué pasó en una frase, a quién afectó, desde cuándo, la causa probable con su evidencia, qué hacer y un nivel de confianza); stack (los marcos de la falla en los archivos del proyecto, con las líneas de código alrededor; para una falla del servidor es la pila del error que recibió el navegador); breadcrumbs (lo que hizo la persona justo antes, clic por clic); trace (la petición que falló, seguida del navegador a la API y a las llamadas detrás); release (la versión en la que empezó, con sus commits y archivos cambiados); impact (cuántas personas y sesiones) y sessions para mirar. Las rutas de archivos son relativas a la raíz del repositorio. Cuando analysis.status es not_enough_evidence u off no hay causa: el agente debe encontrarla con la pila, los pasos previos y los cambios de la versión, y decírtelo. Las partes que faltan se listan en missing con la razón.

Llama a: GET /v1/problems/{problem}/context

Entrada

  • id
    string obligatorio

    El slug del problema (por ejemplo pay-button-does-nothing) o su id (prb_…), como lo devuelven problems, health o search.

  • session
    string opcional

    Arma la pila, los pasos previos y la traza con la ocurrencia de esta sesión en vez de la más reciente. Un id de sesión de sessions.

  • breadcrumbs
    integer, 0 a 100 opcional

    Cuántos eventos anteriores a la falla incluir.

    Por defecto: 30

  • source_lines
    integer, 0 a 20 opcional

    Líneas de código alrededor de cada marco, a cada lado.

    Por defecto: 5

Llamada

JSON
{
  "name": "problem",
  "arguments": {
    "id": "pay-button-does-nothing"
  }
}

Resultado

JSON
{
  "problem": {
    "id": "prb_8f3k2m9x4q7w",
    "slug": "pay-button-does-nothing",
    "kind": "failed_call",
    "status": "open",
    "title": "createPayment answered 400 in POST /api/checkout",
    "route": "/checkout",
    "where": {
      "file": "src/checkout/checkout.tsx",
      "line": 142,
      "function": "confirmPayment"
    },
    "first_seen": "2026-03-12T09:12:04Z",
    "last_seen": "2026-03-12T10:31:47Z",
    "first_release": "4f2a91c",
    "occurrences": 5,
    "people": 3,
    "sessions": 3,
    "url": "https://app.sypnia.com/shop/problems/pay-button-does-nothing",
    "origin": "server"
  },
  "analysis": {
    "status": "ready",
    "sentence": "3 people tried to pay today and could not. The Pay button does nothing since yesterday's change.",
    "who": "3 people. Two of them tried again and gave up.",
    "doing": "Paying for an order, at the last step of checkout.",
    "since": "Yesterday's change, deployed at 18:40. It worked before.",
    "cause": {
      "text": "Release 4f2a91c renamed the cart's total from cart.total to cart.totalCents. The checkout still reads cart.total, so the payment goes out without an amount and the API answers 400.",
      "evidence": [
        {
          "kind": "release_change",
          "ref": "4f2a91c:src/cart/cart.ts",
          "text": "The release renames `total` to `totalCents` in the Cart type."
        },
        {
          "kind": "stack_frame",
          "ref": "src/checkout/checkout.tsx:142",
          "text": "confirmPayment() still passes `cart.total` to createPayment()."
        },
        {
          "kind": "trace",
          "ref": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
          "text": "POST /api/checkout answered 400 with the code `amount_required`."
        },
        {
          "kind": "timing",
          "ref": "4f2a91c",
          "text": "No failure of this kind before the release went live. All 5 failures are on it."
        }
      ]
    },
    "what_to_do": "Read cart.totalCents in confirmPayment(), and show the customer a message when a payment is rejected.",
    "confidence": "high"
  },
  "stack": {
    "origin": "browser",
    "error": {
      "name": "ApiError",
      "message": "POST /api/checkout failed with 400 (amount_required)"
    },
    "symbolicated": true,
    "frames": [
      {
        "function": "createPayment",
        "file": "src/lib/api.ts",
        "line": 27,
        "in_app": true,
        "source": {
          "start_line": 25,
          "lines": [
            "  const res = await fetch('/api/checkout', { method: 'POST', body: JSON.stringify(input) });",
            "  if (!res.ok) {",
            "    throw new ApiError('POST', '/api/checkout', res.status, await errorCode(res));",
            "  }",
            "  return res.json();"
          ]
        }
      },
      {
        "function": "confirmPayment",
        "file": "src/checkout/checkout.tsx",
        "line": 142,
        "in_app": true,
        "source": {
          "start_line": 140,
          "lines": [
            "async function confirmPayment(cart: Cart) {",
            "  setPaying(true);",
            "  const payment = await createPayment({ amount: cart.total, currency: cart.currency });",
            "  router.push(`/orders/${payment.orderId}`);",
            "}"
          ]
        }
      },
      {
        "function": "onClick",
        "file": "src/checkout/pay-button.tsx",
        "line": 18,
        "in_app": true,
        "source": null
      }
    ]
  },
  "breadcrumbs": [
    {
      "offset_ms": 12412,
      "type": "page_view",
      "text": "Opened /checkout (from /cart)"
    },
    {
      "offset_ms": 27090,
      "type": "click",
      "text": "Clicked button «Pay $64.00» in «Your order»"
    },
    {
      "offset_ms": 29310,
      "type": "rage_click",
      "text": "Clicked button «Pay $64.00» 4 more times"
    },
    {
      "offset_ms": 31000,
      "type": "request",
      "text": "POST /api/checkout answered 400 amount_required after 3,870 ms",
      "trace_id": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c"
    }
  ],
  "trace": {
    "id": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c",
    "duration_ms": 3870,
    "status_code": 400,
    "spans": [
      {
        "name": "POST /api/checkout",
        "kind": "browser",
        "service": "browser",
        "start_offset_ms": 0,
        "duration_ms": 3870,
        "status": "error"
      },
      {
        "name": "POST /api/checkout",
        "kind": "server",
        "service": "shop-api",
        "start_offset_ms": 14,
        "duration_ms": 3842,
        "status": "error"
      },
      {
        "name": "SELECT carts",
        "kind": "db",
        "service": "shop-api",
        "start_offset_ms": 21,
        "duration_ms": 12,
        "status": "ok"
      },
      {
        "name": "createPayment",
        "kind": "http",
        "service": "shop-api",
        "start_offset_ms": 46,
        "duration_ms": 3790,
        "status": "error",
        "attributes": {
          "peer.service": "payments",
          "http.response.status_code": 400,
          "error.type": "amount_required"
        }
      }
    ]
  },
  "release": {
    "version": "4f2a91c",
    "deployed_at": "2026-03-11T18:40:00Z",
    "previous_version": "9c1e7b2",
    "changes": {
      "commits": [
        {
          "sha": "4f2a91c",
          "message": "Rename cart.total to cart.totalCents"
        }
      ],
      "files": [
        {
          "path": "src/cart/cart.ts",
          "additions": 3,
          "deletions": 3,
          "patch": "@@ -8,7 +8,7 @@ export interface Cart {\n   items: CartItem[];\n   currency: string;\n-  total: number;\n+  totalCents: number;\n }"
        },
        {
          "path": "src/cart/cart-summary.tsx",
          "additions": 2,
          "deletions": 2
        }
      ]
    }
  },
  "impact": {
    "people": 3,
    "sessions": 3,
    "occurrences": 5,
    "people_who_retried": 2,
    "last_success_before": "2026-03-11T17:52:30Z"
  },
  "sessions": [
    {
      "id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
      "started_at": "2026-03-12T10:31:16Z",
      "has_replay": true,
      "occurrences": 1,
      "url": "https://app.sypnia.com/shop/sessions/8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0?at=31000"
    }
  ],
  "missing": []
}

problem_prompt

MotorNube

Trae el prompt que Sypnia ya tiene listo para arreglar un problema, en texto plano: qué pasa, dónde, por qué, qué hacer, cómo comprobarlo, y después la evidencia. Es el mismo texto que una persona copia de Sypnia a un agente de código. Sirve cuando el agente quiere un resumen corto que seguir o que pasarle a otro agente. Si va a arreglar el problema él mismo y quiere datos con estructura, problem devuelve lo mismo en JSON, con más detalle.

Llama a: GET /v1/problems/{problem}/prompt

Entrada

  • id
    string obligatorio

    El slug o el id del problema.

Llamada

JSON
{
  "name": "problem_prompt",
  "arguments": {
    "id": "pay-button-does-nothing"
  }
}

Resultado

JSON
{
  "analysis_status": "ready",
  "prompt": "Fix a production bug reported by Sypnia.\n\nWhat happens: clicking Pay does nothing. 3 people hit it today (2026-03-12),\n  since release 4f2a91c (deployed 2026-03-11 18:40 UTC).\nWhere: src/checkout/checkout.tsx:142, confirmPayment()\nWhy: that release renamed cart.total to cart.totalCents, but\n  checkout.tsx still reads cart.total. The payment goes out\n  with amount undefined and the API answers 400.\n  Confidence: high.\nDo: read cart.totalCents in confirmPayment(), and show the\n  customer a message when a payment is rejected.\nCheck: session 8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0 shows the clicks.\n  Add a test that fails when the amount is missing.\n\n… (the evidence and the rules follow; the full text is on the page «The prompt»)"
}

sessions

MotorNube

Lista sesiones: visitas de personas reales a la app. Con problem devuelve las sesiones que ese problema afectó, con cuántas veces pasó en cada una y cuándo. Sin él lista sesiones recientes, por defecto solo las que tuvieron dificultades (un error, un clic de rabia, un clic muerto o una petición fallida); se filtra por person, route o release. Sirve para ver a quién afectó y para elegir una sesión que leer con session. Las personas vuelven con el id que les dio la app, y con nombre o correo solo si la app los envió.

Llama a: GET /v1/problems/{problem}/sessions or GET /v1/sessions

Entrada

  • problem
    string opcional

    El slug o el id de un problema: devuelve las sesiones que afectó.

  • person
    string opcional

    Solo sesiones de la persona con este id. No se combina con problem.

  • route
    string opcional

    Solo sesiones que visitaron esta página, por ejemplo /checkout. No se combina con problem.

  • release
    string opcional

    Solo sesiones en esta versión. No se combina con problem.

  • trouble
    boolean opcional

    false devuelve también las sesiones donde nada salió mal. Se ignora con problem.

    Por defecto: true

  • since
    string opcional

    Solo sesiones posteriores a este momento.

    Por defecto: 7d

  • environment
    string opcional

    El entorno que se mira.

    Por defecto: production

  • limit
    integer, 1 a 50 opcional

    Cuántas sesiones devolver.

    Por defecto: 10

  • cursor
    string opcional

    El next_cursor de la llamada anterior.

Llamada

JSON
{
  "name": "sessions",
  "arguments": {
    "problem": "pay-button-does-nothing"
  }
}

Resultado

JSON
{
  "sessions": [
    {
      "id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
      "started_at": "2026-03-12T10:31:16Z",
      "duration_ms": 42000,
      "person": {
        "id": "u_1042",
        "name": "Ada Park"
      },
      "device": "desktop",
      "browser": "Chrome 134",
      "release": "4f2a91c",
      "errors": 1,
      "rage_clicks": 1,
      "failed_requests": 1,
      "has_replay": true,
      "occurrences": 1,
      "first_occurrence_at": "2026-03-12T10:31:47Z"
    },
    {
      "id": "2b7d9e4f1a6c4830b5d2f7e9c1a3b5d7",
      "started_at": "2026-03-12T09:47:40Z",
      "duration_ms": 82000,
      "person": {
        "id": "u_0977"
      },
      "device": "mobile",
      "browser": "Safari 18",
      "release": "4f2a91c",
      "errors": 2,
      "rage_clicks": 0,
      "failed_requests": 2,
      "has_replay": true,
      "occurrences": 2,
      "first_occurrence_at": "2026-03-12T09:48:11Z"
    },
    {
      "id": "c4e1a8f3d7b24c69a0e5d3b1f9c7a5e3",
      "started_at": "2026-03-12T09:11:26Z",
      "duration_ms": 109000,
      "person": null,
      "device": "desktop",
      "browser": "Chrome 134",
      "release": "4f2a91c",
      "errors": 2,
      "rage_clicks": 0,
      "failed_requests": 2,
      "has_replay": true,
      "occurrences": 2,
      "first_occurrence_at": "2026-03-12T09:12:04Z"
    }
  ],
  "next_cursor": null
}

session

MotorNube

Lee lo que hizo una persona en una sesión, como una línea de tiempo en palabras simples: páginas abiertas, cosas tocadas (por su etiqueta visible), clics de rabia, llamadas a la API que fallaron, errores, formularios que el navegador rechazó y eventos propios. Es la forma en texto de la grabación de la sesión: da los pasos para reproducir una falla. Nunca trae lo que la persona escribió, y no devuelve video ni capturas. Por defecto solo vuelven los eventos notables; con notable en false también las llamadas exitosas y las mediciones de rendimiento. around sirve para leer los momentos antes y después de una falla.

Llama a: GET /v1/sessions/{session}/events

Entrada

  • id
    string obligatorio

    El id de la sesión, 32 caracteres hexadecimales, de sessions o de las sessions de un problema.

  • notable
    boolean opcional

    true: vistas de página, clics, clics de rabia y muertos, errores, peticiones fallidas, fallas de formularios y eventos propios. false: todo.

    Por defecto: true

  • around
    timestamp opcional

    Una fecha ISO 8601 dentro de la sesión. Devuelve los eventos alrededor de ese momento en vez de empezar por el principio.

  • limit
    integer, 1 a 500 opcional

    Cuántos eventos devolver.

    Por defecto: 100

  • cursor
    string opcional

    El next_cursor de la llamada anterior.

Llamada

JSON
{
  "name": "session",
  "arguments": {
    "id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0"
  }
}

Resultado

JSON
{
  "session": {
    "id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
    "started_at": "2026-03-12T10:31:16Z",
    "duration_ms": 42000,
    "person": {
      "id": "u_1042",
      "name": "Ada Park"
    },
    "device": "desktop",
    "browser": "Chrome 134",
    "release": "4f2a91c",
    "has_replay": true
  },
  "events": [
    {
      "offset_ms": 0,
      "type": "page_view",
      "route": "/cart",
      "text": "Opened /cart"
    },
    {
      "offset_ms": 12412,
      "type": "page_view",
      "route": "/checkout",
      "text": "Opened /checkout (from /cart)"
    },
    {
      "offset_ms": 27090,
      "type": "click",
      "route": "/checkout",
      "text": "Clicked button «Pay $64.00» in «Your order»"
    },
    {
      "offset_ms": 29310,
      "type": "rage_click",
      "route": "/checkout",
      "text": "Clicked button «Pay $64.00» 4 more times"
    },
    {
      "offset_ms": 31000,
      "type": "request",
      "route": "/checkout",
      "text": "POST /api/checkout answered 400 amount_required after 3,870 ms",
      "trace_id": "7c2e9a4b1d8f4e6a9b3c5d7e1f2a4b6c"
    },
    {
      "offset_ms": 31004,
      "type": "error",
      "route": "/checkout",
      "text": "ApiError: POST /api/checkout failed with 400 (amount_required)",
      "problem": "pay-button-does-nothing"
    },
    {
      "offset_ms": 42230,
      "type": "page_leave",
      "route": "/checkout",
      "text": "Left /checkout after 30 s"
    }
  ],
  "next_cursor": null
}
MotorNube

Encuentra cosas en Sypnia por texto cuando no hay un id: problemas (por palabras de su frase, título, archivo o función), sesiones y trazas (por id o sus primeros 8 caracteres), personas y cuentas (por id, nombre o correo, si la app los envió), versiones (por su nombre) y páginas (por ruta). Sirve cuando describes una falla con tus palabras («el error del cupón», «qué le pasó a ada@example.com») o pegas un id de otro lado. Los resultados vienen agrupados por tipo; se sigue con problem, session o sessions.

Llama a: GET /v1/search

Entrada

  • q
    string, hasta 120 caracteres obligatorio

    El texto que se busca.

  • types
    lista de string opcional

    Dónde buscar. En todo si se omite. Uno de: problems, sessions, people, accounts, traces, releases, pages.

  • since
    string opcional

    Solo cuentan las sesiones, trazas y actividad posteriores a este momento.

    Por defecto: 30d

  • environment
    string opcional

    El entorno que se mira.

    Por defecto: production

  • limit
    integer, 1 a 25 opcional

    Máximo de resultados por tipo.

    Por defecto: 5

Llamada

JSON
{
  "name": "search",
  "arguments": {
    "q": "ada@example.com"
  }
}

Resultado

JSON
{
  "q": "ada@example.com",
  "problems": [],
  "sessions": [],
  "people": [
    {
      "id": "u_1042",
      "name": "Ada Park",
      "email": "ada@example.com",
      "account": {
        "id": "acc_77",
        "name": "Corner Café"
      },
      "last_seen": "2026-03-12T10:31:58Z",
      "sessions": 6,
      "trouble_sessions": 1,
      "latest_sessions": [
        {
          "id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0",
          "started_at": "2026-03-12T10:31:16Z",
          "trouble": true
        }
      ]
    }
  ],
  "accounts": [],
  "traces": [],
  "releases": [],
  "pages": []
}

performance

MotorNube

Muestra qué tan rápida es la app para visitantes reales y qué empeoró. Sin route devuelve los números de carga de la app (LCP, INP, CLS y TTFB en el percentil 75), las páginas que se pusieron más lentas frente al periodo anterior, las más lentas, las llamadas a la API lentas o que fallan, las páginas donde la gente hace clics de rabia y cuántas sugerencias de mejora esperan. Con route devuelve el detalle de una página: sus números, el elemento detrás de cada uno (qué imagen es la pintura principal lenta, qué control tarda en responder), los elementos con clics de rabia o clics muertos y los formularios que el navegador rechazó. Sirve cuando preguntas por qué una página está lenta, qué optimizar o si una versión hizo todo más lento. Los tiempos están en milisegundos.

Llama a: GET /v1/performance, or with route: GET /v1/performance/pages, /v1/performance/vitals, /v1/clicks and /v1/form-failures

Entrada

  • route
    string opcional

    La ruta de una página, por ejemplo /search. Se omite para toda la app.

  • since
    string opcional

    El periodo que se mide. Se compara con el periodo de la misma duración justo antes.

    Por defecto: 7d

  • device
    string opcional

    Solo mediciones de este tipo de dispositivo. Todos si se omite. Uno de: mobile, tablet, desktop.

  • environment
    string opcional

    El entorno que se mira.

    Por defecto: production

Llamada

JSON
{
  "name": "performance",
  "arguments": {
    "route": "/search",
    "since": "24h"
  }
}

Resultado

JSON
{
  "route": "/search",
  "page": {
    "views": 1840,
    "lcp_p75_ms": 3100,
    "previous_lcp_p75_ms": 1900,
    "inp_p75_ms": 180,
    "cls_p75": 0.04,
    "ttfb_p75_ms": 410,
    "poor_share": 0.21
  },
  "elements": {
    "lcp": [
      {
        "selector": "main ul.results > li:nth-child(1) img",
        "kind": "image",
        "samples": 1310,
        "p75_ms": 3200,
        "poor_share": 0.24
      }
    ],
    "inp": [
      {
        "selector": "form.filters select#sort",
        "kind": "pointer",
        "samples": 640,
        "p75_ms": 210,
        "poor_share": 0.03
      }
    ],
    "cls": [
      {
        "selector": "aside.promo",
        "samples": 480,
        "p75": 0.06,
        "poor_share": 0.02
      }
    ]
  },
  "clicks": [
    {
      "selector": "ul.results li .badge",
      "role": "text",
      "label": "Free shipping",
      "clicks": 31,
      "rage_clicks": 2,
      "dead_clicks": 9
    }
  ],
  "form_failures": [],
  "suggestions": [
    {
      "id": "sug_3h7j1k5l9p2o",
      "title": "The search page's first product image loads slowly",
      "status": "new"
    }
  ]
}

uptime

MotorNube

Muestra si la app responde desde afuera. Devuelve cada comprobación de disponibilidad (una URL que Sypnia pide cada cierto tiempo) con su estado (up, down, paused), desde cuándo está caída, cómo salió la última comprobación y qué parte de las comprobaciones pasó en las últimas 24 horas y 30 días. Con check devuelve además las caídas recientes de esa comprobación, cada una con su inicio, su fin y su razón. Sirve cuando preguntas si el sitio está caído, o estuvo caído, y por cuánto tiempo.

Llama a: GET /v1/uptime/checks, and GET /v1/uptime/checks/{check_id}/results with check

Entrada

  • check
    string opcional

    El id de una comprobación (chk_…), para traer también sus caídas.

  • since
    string opcional

    Con check: hasta dónde mirar hacia atrás para buscar caídas.

    Por defecto: 24h

Llamada

JSON
{
  "name": "uptime",
  "arguments": {}
}

Resultado

JSON
{
  "down": 0,
  "checks": [
    {
      "id": "chk_1q9w3e7r5t2y",
      "name": "Shop home",
      "url": "https://shop.example.com/",
      "status": "up",
      "down_since": null,
      "last_checked_at": "2026-03-12T10:34:00Z",
      "last_status_code": 200,
      "last_response_ms": 184,
      "uptime_24h": 100,
      "uptime_30d": 99.98
    }
  ]
}

resolve_problem

MotorNube

Marca un problema como resuelto después de que su arreglo tiene merge o está desplegado. Es la única herramienta que cambia algo en Sypnia. El agente debe llamarla solo cuando el arreglo existe en el repositorio, no cuando apenas lo propuso, y avisarte que lo hizo. Es segura: si la falla vuelve a ocurrir, Sypnia reabre el problema por su cuenta y alerta. Con release se indica la versión que trae el arreglo, para que las fallas de personas que siguen en la versión anterior no lo reabran. Resolver un problema que ya está resuelto no cambia nada.

Esta herramienta escribe.

Llama a: POST /v1/problems/{problem}/resolve

Entrada

  • id
    string obligatorio

    El slug o el id del problema.

  • release
    string, hasta 64 caracteres opcional

    La versión que trae el arreglo, normalmente el commit corto de git del arreglo ya desplegado.

  • note
    string, hasta 500 caracteres opcional

    Una línea sobre qué lo arregló, para quien lea el problema después: el commit, el pull request, la causa.

Llamada

JSON
{
  "name": "resolve_problem",
  "arguments": {
    "id": "pay-button-does-nothing",
    "release": "5b3c8d2",
    "note": "Fixed in pull request 128."
  }
}

Resultado

JSON
{
  "id": "prb_8f3k2m9x4q7w",
  "slug": "pay-button-does-nothing",
  "status": "resolved",
  "resolved_at": "2026-03-12T11:20:44Z",
  "resolved_by": "mcp:Cursor",
  "resolved_in_release": "5b3c8d2",
  "note": "Fixed in pull request 128."
}

Recursos

Para clientes que dejan que una persona adjunte un recurso a la conversación. Cada uno devuelve los mismos datos que una herramienta.

RecursoQué es
sypnia://problems/openLos problemas abiertos en producción, como los devuelve problems
sypnia://problem/{id}Un problema con su contexto, como lo devuelve problem. id es el slug o el id
sypnia://problem/{id}/promptEl prompt listo de un problema, en texto plano

Prompts

Peticiones ya escritas que los clientes MCP muestran como comandos (en Claude Code, /mcp__sypnia__fix_problem).

PromptArgumentosQué le pide al agente
whats_failingNingunoRevisar producción con health y contarlo en palabras simples, sin cambiar código
fix_problemid, opcionalLeer el contexto del problema, confirmar la causa en el código, hacer el arreglo más pequeño, agregar una prueba, mostrar el cambio y llamar a resolve_problem cuando confirmes que el arreglo tiene merge o está desplegado

El texto completo de fix_problem (el servidor lo entrega en inglés):

Text
Fix the Sypnia problem «{id}». If no id is given, call `problems` with sort `people` and take the first.
1. Call `problem` to get its context. Read the analysis, the stack and the release's changes.
2. Open the files it names and confirm the cause in the code before changing anything. If the code does not match the analysis, stop and tell me what you found.
3. Make the smallest change that fixes the cause. Do not touch unrelated code.
4. Add a test that fails without the fix and passes with it. Run the tests.
5. Show me the change. Do not merge or deploy.
6. When I confirm the fix is merged or deployed, call `resolve_problem` with a one-line note.

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar