Referencia de herramientas
Cada herramienta del servidor MCP de Sypnia: para qué sirve, su entrada y una llamada de ejemplo con su resultado.
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? |
|---|---|---|
health | Preguntar «¿qué está fallando en producción?» | No |
problems | Listar problemas | No |
problem | Traer un problema con todo lo necesario para arreglarlo | No |
problem_prompt | Traer el prompt listo de un problema, como texto | No |
sessions | Listar las sesiones que un problema afectó, o las sesiones recientes | No |
session | Leer una sesión, evento por evento | No |
search | Encontrar un problema, sesión, persona, versión o página por texto | No |
performance | Ver páginas lentas, llamadas a la API lentas o que fallan, y qué empeoró | No |
uptime | Ver si la app responde | No |
resolve_problem | Marcar un problema como resuelto después del arreglo | Sí |
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 esproduction. - 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
codey elmessagede la API, por ejemplonot_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.
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
-
sincestring opcionalHasta 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 -
environmentstring opcionalEl entorno que se mira, por ejemplo
productionodevelopment.Por defecto:
production
Llamada
{
"name": "health",
"arguments": {}
}Resultado
{
"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
}
}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
-
statusstring opcionalopen: está pasando o nadie lo ha marcado como arreglado.resolved: marcado como arreglado.ignored: conocido y aceptado.Por defecto:
open -
qstring, hasta 120 caracteres opcionalPalabras que buscar en la frase, el título o el nombre del archivo, por ejemplo
checkoutoamount_required. -
releasestring opcionalSolo problemas vistos en esta versión (la versión de la app, normalmente un commit corto de git como
4f2a91c). -
routestring opcionalSolo problemas en esta página o ruta de la API, por ejemplo
/checkouto/api/orders/:id. -
sincestring opcionalSolo problemas vistos después de este momento:
24h,7do una fecha ISO 8601.Por defecto:
30d -
sortstring opcionalpeoplepone primero los problemas que afectaron a más personas. Uno de:last_seen,first_seen,people,occurrences.Por defecto:
last_seen -
environmentstring opcionalEl entorno que se mira.
Por defecto:
production -
limitinteger, 1 a 50 opcionalCuántos problemas devolver.
Por defecto:
10 -
cursorstring opcionalEl
next_cursorde la llamada anterior, para traer la página siguiente.
Llamada
{
"name": "problems",
"arguments": {
"status": "open"
}
}Resultado
{
"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
}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
-
idstring obligatorioEl
slugdel problema (por ejemplopay-button-does-nothing) o suid(prb_…), como lo devuelvenproblems,healthosearch. -
sessionstring opcionalArma 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. -
breadcrumbsinteger, 0 a 100 opcionalCuántos eventos anteriores a la falla incluir.
Por defecto:
30 -
source_linesinteger, 0 a 20 opcionalLíneas de código alrededor de cada marco, a cada lado.
Por defecto:
5
Llamada
{
"name": "problem",
"arguments": {
"id": "pay-button-does-nothing"
}
}Resultado
{
"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": []
}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
-
idstring obligatorioEl
slugo eliddel problema.
Llamada
{
"name": "problem_prompt",
"arguments": {
"id": "pay-button-does-nothing"
}
}Resultado
{
"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»)"
}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
-
problemstring opcionalEl
slugo elidde un problema: devuelve las sesiones que afectó. -
personstring opcionalSolo sesiones de la persona con este id. No se combina con
problem. -
routestring opcionalSolo sesiones que visitaron esta página, por ejemplo
/checkout. No se combina conproblem. -
releasestring opcionalSolo sesiones en esta versión. No se combina con
problem. -
troubleboolean opcionalfalsedevuelve también las sesiones donde nada salió mal. Se ignora conproblem.Por defecto:
true -
sincestring opcionalSolo sesiones posteriores a este momento.
Por defecto:
7d -
environmentstring opcionalEl entorno que se mira.
Por defecto:
production -
limitinteger, 1 a 50 opcionalCuántas sesiones devolver.
Por defecto:
10 -
cursorstring opcionalEl
next_cursorde la llamada anterior.
Llamada
{
"name": "sessions",
"arguments": {
"problem": "pay-button-does-nothing"
}
}Resultado
{
"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
}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
-
idstring obligatorioEl id de la sesión, 32 caracteres hexadecimales, de
sessionso de lassessionsde un problema. -
notableboolean opcionaltrue: vistas de página, clics, clics de rabia y muertos, errores, peticiones fallidas, fallas de formularios y eventos propios.false: todo.Por defecto:
true -
aroundtimestamp opcionalUna fecha ISO 8601 dentro de la sesión. Devuelve los eventos alrededor de ese momento en vez de empezar por el principio.
-
limitinteger, 1 a 500 opcionalCuántos eventos devolver.
Por defecto:
100 -
cursorstring opcionalEl
next_cursorde la llamada anterior.
Llamada
{
"name": "session",
"arguments": {
"id": "8f3a6c1e9b2d4f07a5c3e1b8d6f4a2c0"
}
}Resultado
{
"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
}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
-
qstring, hasta 120 caracteres obligatorioEl texto que se busca.
-
typeslista de string opcionalDónde buscar. En todo si se omite. Uno de:
problems,sessions,people,accounts,traces,releases,pages. -
sincestring opcionalSolo cuentan las sesiones, trazas y actividad posteriores a este momento.
Por defecto:
30d -
environmentstring opcionalEl entorno que se mira.
Por defecto:
production -
limitinteger, 1 a 25 opcionalMáximo de resultados por tipo.
Por defecto:
5
Llamada
{
"name": "search",
"arguments": {
"q": "ada@example.com"
}
}Resultado
{
"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": []
}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
-
routestring opcionalLa ruta de una página, por ejemplo
/search. Se omite para toda la app. -
sincestring opcionalEl periodo que se mide. Se compara con el periodo de la misma duración justo antes.
Por defecto:
7d -
devicestring opcionalSolo mediciones de este tipo de dispositivo. Todos si se omite. Uno de:
mobile,tablet,desktop. -
environmentstring opcionalEl entorno que se mira.
Por defecto:
production
Llamada
{
"name": "performance",
"arguments": {
"route": "/search",
"since": "24h"
}
}Resultado
{
"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"
}
]
}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
-
checkstring opcionalEl id de una comprobación (
chk_…), para traer también sus caídas. -
sincestring opcionalCon
check: hasta dónde mirar hacia atrás para buscar caídas.Por defecto:
24h
Llamada
{
"name": "uptime",
"arguments": {}
}Resultado
{
"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
}
]
}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
-
idstring obligatorioEl
slugo eliddel problema. -
releasestring, hasta 64 caracteres opcionalLa versión que trae el arreglo, normalmente el commit corto de git del arreglo ya desplegado.
-
notestring, hasta 500 caracteres opcionalUna línea sobre qué lo arregló, para quien lea el problema después: el commit, el pull request, la causa.
Llamada
{
"name": "resolve_problem",
"arguments": {
"id": "pay-button-does-nothing",
"release": "5b3c8d2",
"note": "Fixed in pull request 128."
}
}Resultado
{
"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.
| Recurso | Qué es |
|---|---|
sypnia://problems/open | Los 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}/prompt | El 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).
| Prompt | Argumentos | Qué le pide al agente |
|---|---|---|
whats_failing | Ninguno | Revisar producción con health y contarlo en palabras simples, sin cambiar código |
fix_problem | id, opcional | Leer 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):
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.