Herramientas Disponibles
Catálogo completo de las capacidades del Race Engineer organizadas por categoría.
El Race Engineer proporciona 96 herramientas en 20 grupos. Todas están disponibles a través de la conexión MCP — tu asistente IA las descubre automáticamente.
Cómo Funcionan las Herramientas
El Race Engineer usa una única herramienta execute_code. Tu asistente IA escribe código TypeScript que llama a funciones brakinglab.* para interactuar con tus datos. No necesitas conocer los nombres de las funciones — simplemente describe lo que quieres en lenguaje natural.
Por ejemplo, preguntar “Muéstrame mis sesiones recientes en Spa” hace que el asistente llame a brakinglab.getSessions({ trackName: "Spa" }) internamente.
Sesiones y Vueltas
Explora tus sesiones de telemetría y datos de vuelta.
| Herramienta | Descripción |
|---|---|
| getSessions | Lista y filtra tus sesiones por circuito, coche, fecha o tipo |
| getSessionDetail | Detalle completo de sesión con todas las vueltas, clima e info del piloto |
| getSessionsFacets | Descubre los circuitos, coches, sims y tipos de sesión presentes en tus datos antes de filtrar |
| getLatestSession | Salta directo a tu sesión más reciente que coincida con filtros opcionales |
Prompts de ejemplo:
- “Muéstrame mis últimas 5 sesiones”
- “Encuentra todas mis sesiones en Monza con el Ferrari GT3”
- “¿Cuál fue mi mejor vuelta en la sesión de ayer?”
Stints
Analiza el rendimiento a lo largo de stints dentro de una sesión.
| Herramienta | Descripción |
|---|---|
| listSessionStints | Lista stints (tramos pit-a-pit) de una sesión con informes de coaching vinculados |
| getStintMetrics | Métricas detalladas de stint incluyendo rendimiento curva por curva |
Análisis de Curvas
Profundiza en curvas individuales.
| Herramienta | Descripción |
|---|---|
| getCornerAnalysis | Velocidad de entrada, ápice, salida y G lateral por curva |
| getTrackTemplate | Mapa estructural del circuito mostrando curvas, zonas defensivas y pit |
| getTrackOutline | El contorno geométrico del circuito en puntos normalizados, para que el asistente pueda dibujarlo |
Prompts de ejemplo:
- “¿En qué curvas soy más lento en este circuito?”
- “Muéstrame el análisis de curvas de la vuelta 12”
Zonas de Frenado
Datos detallados de frenado para cada zona.
| Herramienta | Descripción |
|---|---|
| getBrakingZones | Valores de MRP, características de trail braking, perfiles de freno y datos de deceleración |
Prompts de ejemplo:
- “Muéstrame mis zonas de frenado de la mejor vuelta”
- “¿Dónde estoy frenando demasiado pronto?”
Análisis a Nivel de Muestra
Haz zoom hasta la telemetría en bruto — cada muestra de freno, acelerador y velocidad — para ver la forma de tu conducción, no solo los agregados. Requiere un plan Plus o Ultra.
| Herramienta | Descripción |
|---|---|
| getLapTrace | Traza a resolución completa de una vuelta (freno, acelerador, velocidad, dirección, marcha, combustible y más), acotada a cualquier parte de la vuelta y submuestreada para el análisis |
| getZoneTrace | Traza a nivel de muestra de una única zona de frenado — el ataque inicial, la curva de liberación y el trail-off hacia el ápice |
| compareTraces | Duela dos vueltas muestra a muestra en una rejilla alineada por distancia — incluida tu vuelta contra la del líder actual del leaderboard — con el delta de tiempo acumulado en cada punto |
| getDrivingSymptoms | Diagnóstico de subviraje / sobreviraje / límite de tracción por curva, cada uno respaldado por evidencia numérica de la telemetría en bruto |
| getZoneConsistency | Clasifica tus zonas de frenado por lo repetibles que son a lo largo de cada vuelta válida, para encontrar dónde te cuesta tiempo la inconsistencia |
Prompts de ejemplo:
- “Compara mi mejor vuelta de Spa con la del líder del leaderboard, curva por curva”
- “¿Dónde estoy subvirando, y cuánto?”
- “¿En qué zona de frenado soy menos consistente?”
- “Muéstrame la forma de liberación del freno en la curva 1 en mi vuelta más rápida”
Las herramientas a nivel de muestra requieren un plan Plus o Ultra. Comparar contra una vuelta del leaderboard también requiere que ese piloto haya compartido su telemetría públicamente, y ambas vueltas deben ser del mismo coche y circuito.
Coaching
Coaching y análisis potenciado por IA.
| Herramienta | Descripción |
|---|---|
| saveCoachingReport | Genera y guarda un informe de coaching estructurado (resumen, ritmo, curvas, acciones) |
| getCoachingReports | Lista todos los informes de coaching de una sesión |
| getCoachingReport | Obtiene un informe de coaching específico por ID |
Prompts de ejemplo:
- “Analiza mi última sesión y dame feedback de coaching”
- “Genera un informe de coaching de mi práctica en Spa”
Análisis de Vueltas
Comparación avanzada y análisis de tendencias.
| Herramienta | Descripción |
|---|---|
| compareLaps | Compara 2-5 vueltas con deltas de frenado por zona y diferencias de tiempo |
| getProgressOverTime | Tendencia de mejora entre sesiones en un circuito |
| getWeakCorners | Identifica tus curvas más débiles clasificadas por inconsistencia |
| getSectorAnalysis | Consistencia por sector y mejor teórica de una sesión |
| getTireDegradation | Desgaste, temperatura y presión de gomas vuelta a vuelta a lo largo de una sesión |
Prompts de ejemplo:
- “Compara mi mejor y peor vuelta de la sesión de hoy”
- “¿Cómo he mejorado en Silverstone en el último mes?”
- “¿Cuáles son mis curvas más débiles en este circuito?”
- “¿Cuánto se me fueron las gomas al final de esa tanda?”
Los datos de gomas vienen de las instantáneas que graba el cliente de escritorio durante la sesión. Si una sesión es anterior a esa captura, el ingeniero lo dice en vez de inventarse una tendencia.
Calendario de Carreras
Gestiona tu agenda de carreras.
| Herramienta | Descripción |
|---|---|
| getUpcomingRaces | Tus próximas carreras con estado de preparación |
| getAllRaces | Calendario completo (pasado y futuro) con filtros |
| getRaceDetail | Detalle completo de carrera con preparaciones, estrategia y sesiones vinculadas |
| createRaceEvent | Crear un nuevo evento de carrera |
| updateRaceEvent | Actualizar detalles del evento |
| deleteRaceEvent | Eliminar un evento de carrera |
| linkSessionToRace | Vincular una sesión de telemetría a un evento como práctica |
| getUnlinkedSessionsForRace | Encontrar sesiones de práctica que coincidan con el circuito y coche de una carrera |
| getRaceReadinessData | Recopilar datos de todas las sesiones de práctica para una evaluación de preparación cruzada |
| saveRaceReadinessReport | Guardar un informe de preparación evaluando tus prácticas en conjunto |
| getRaceReadinessReport | Recuperar un informe de preparación existente para una carrera |
Prompts de ejemplo:
- “¿Estoy preparado para mi carrera en Spa? Evalúa mis sesiones de práctica”
- “Genera un informe de preparación para la carrera de este fin de semana”
Preparación de Carreras
Construye planes de preparación estructurados.
| Herramienta | Descripción |
|---|---|
| getPreparation | Preparación completa con fases, items de checklist y progreso |
| getPreparationTemplates | Plantillas de preparación integradas y personalizadas |
| createPreparation | Crear preparación desde plantilla o fases personalizadas |
| updatePreparation | Editar notas y seguimiento de tiempo |
| updatePreparationPhase | Añadir, actualizar o eliminar una fase de preparación |
| updateChecklistItem | Añadir, actualizar, eliminar o marcar items del checklist |
Prompts de ejemplo:
- “Ayúdame a preparar mi carrera en Spa del próximo sábado”
- “Crea un checklist de preparación para las 24h de Le Mans”
Estrategia
Cálculos de estrategia de carrera.
| Herramienta | Descripción |
|---|---|
| generateStrategyFromTelemetry | Auto-genera estrategia de carrera desde datos de práctica (combustible, ritmo, desgaste, plan de stints) |
| saveRaceStrategy | Guarda la estrategia en una carrera de tu calendario para que sobreviva a la conversación — editable después en la app |
Prompts de ejemplo:
- “Genera una estrategia de combustible para una carrera de 45 minutos basada en mis vueltas de práctica”
- “Guarda esa estrategia en mi carrera de Spa del sábado”
Cada cifra se recalcula en el servidor desde tu telemetría al guardar, así que la card de la app nunca puede contradecir lo que te dijo el ingeniero. Las notas que escribiste en la app se conservan cuando el ingeniero actualiza la estrategia.
Notas de Pista
Accede a tus notas de curva y observaciones de circuito.
| Herramienta | Descripción |
|---|---|
| getTrackNotepads | Lista tus blocs de notas de pista |
| getTrackNotepad | Bloc completo con notas de curva, pines y referencias de vídeo |
| createTrackNotepad | Crear un nuevo bloc de notas de pista |
| updateTrackNotepad | Actualizar notas de curva y pines |
| deleteTrackNotepad | Eliminar un bloc de notas de pista |
| linkNotepadToRace | Vincular un bloc de notas a un evento del calendario de carreras |
| unlinkNotepadFromRace | Desvincular un bloc de notas de una carrera |
Comparaciones Guardadas
Gestiona comparaciones de vueltas guardadas.
| Herramienta | Descripción |
|---|---|
| saveComparison | Guardar una comparación de vueltas con deltas auto-calculados |
| getComparisons | Listar comparaciones guardadas con filtros |
Integración iRacing
Accede a datos de series y horarios de iRacing.
| Herramienta | Descripción |
|---|---|
| searchIRacingSeries | Busca series de iRacing por categoría, licencia o nombre |
| getSeriesSchedule | Horario completo de temporada para una serie |
| searchRacesThisWeek | Todas las series corriendo esta semana |
| createRaceFromSchedule | Crear un evento de calendario desde una entrada del horario de iRacing |
Prompts de ejemplo:
- “¿Qué carreras hay esta semana donde pueda participar con licencia C?”
- “Añade la carrera GT3 de Spa del horario de esta semana a mi calendario”
Le Mans Ultimate
Explora series, circuitos y la semana de carrera actual de Le Mans Ultimate.
| Herramienta | Descripción |
|---|---|
| searchLMUTracks | Busca circuitos de Le Mans Ultimate |
| searchLMUCars | Busca coches de LMU |
| searchLMUSeries | Busca series de LMU |
| getLMUSeriesSchedule | Horario completo de temporada para una serie de LMU |
| getLMUCurrentSchedule | La semana de carrera actual de LMU entre series |
| getLMUSpecialEvents | Eventos especiales y de resistencia de LMU |
| createRaceFromLMUSchedule | Crear un evento de calendario desde una entrada del horario de LMU |
Prompts de ejemplo:
- “¿Cuál es la semana de carrera actual de LMU?”
- “Añade la ronda de Hyperpole en Le Mans a mi calendario”
Vault de Hardware
Accede a tus configuraciones de hardware y datapacks.
| Herramienta | Descripción |
|---|---|
| listDatapacks | Lista tus datapacks con filtros |
| getDatapack | Detalle completo de datapack con archivos adjuntos |
| listHardwareSetups | Lista configuraciones de hardware con resúmenes |
| getHardwareSetup | Configuración completa: base, pedales y perfiles de sim |
Vueltas Importadas
Vueltas que no vienen del cliente de escritorio.
| Herramienta | Descripción |
|---|---|
| getImportedLaps | Lista las vueltas que importaste desde CSV de Garage61 (y las antiguas, previas a Capture), con tus notas por zona |
Prompts de ejemplo:
- “¿Qué vueltas tengo importadas de Monza?”
- “Léeme las notas que escribí en mi vuelta importada de Spa”
Entrenamiento
El cierre del bucle: convertir un diagnóstico en algo que de verdad practicas.
| Herramienta | Descripción |
|---|---|
| createExerciseFromZone | Construye un ejercicio de trail braking desde una zona de frenada de tu propia vuelta — la curva se genera en el servidor a 60 Hz y aparece en Práctica, lista para ejecutar con tus pedales |
| listCustomExercises | Lista tus ejercicios personalizados, con las plazas que te deja tu plan |
| getExerciseResults | Tus puntuaciones de práctica del runner de Free Practice |
| getBrakeMasterProgress | Tu Braking Rating, licencia, racha y progresión por circuitos |
| getBrakeMasterLeaderboard | Global, semanal, o los pilotos justo alrededor de tu posición |
Prompts de ejemplo:
- “Busca mi peor curva en Spa y créame un ejercicio para ella”
- “¿Qué puntuación saqué en ese ejercicio? ¿Estoy mejorando?”
- “¿En qué puesto voy en la clasificación de Brake Master?”
Crear un ejercicio cuenta contra el límite de ejercicios personalizados de tu plan, y el ingeniero te dirá claramente cuándo te has quedado sin plazas en vez de fallar en silencio. Las entradas de la clasificación son anónimas e incluyen solo a quienes han optado por aparecer.
Coaching de Setup
Qué hace de verdad un parámetro del setup — en tu coche, no en abstracto.
Todavía no está encendido. Las herramientas viajan con el ingeniero, pero el corpus revisado del que responden sigue en curación, así que por ahora te dicen que está por llegar en vez de improvisar. La Guía de Setup ya publica la mitad neutral, gratis; lo que esto añade encima es tu coche, tu fichero y tu sesión.
| Herramienta | Descripción |
|---|---|
| explainSetupParam | Explica UN parámetro del setup desde el corpus de conocimiento revisado de Braking Lab, anclado a tu simulador, tu coche y tus propios valores |
| getSetupTendencies | Tendencias de setup curadas para UN síntoma de comportamiento — subviraje, sobreviraje o límite de tracción, acotado a una fase de curva si quieres — revisadas a mano, con notas por coche donde las hemos escrito |
Pregunta con el nombre que conozcas — en lenguaje llano y en tu idioma, la clave
canónica, o la grafía exacta que usa tu garaje — y el ingeniero lo resuelve a un
único parámetro. La respuesta trae qué es, qué hace en cada fase de curva, con
qué se acopla, y la nota revisada para ese coche cuando la hemos escrito (citada,
para que puedas ir a la fuente). Con un sessionId muestra además tu valor
actual, tomado del setup que el cliente de escritorio capturó con esa sesión;
con Setups IA en un plan Plus o Ultra puedes anclarlo a un setup de la bóveda.
Prompts de ejemplo:
- “¿Qué hace realmente el reparto de frenada? Usa mi última sesión en Spa.”
- “¿Por qué llevaría más barra estabilizadora trasera en mojado?”
- “En mi GT4, ¿qué cambia el spring perch offset — y con qué se pelea?”
El Coaching de Setup requiere un plan Plus o Ultra. El ingeniero te dice lo que no sabe con la misma claridad que lo que sabe: si falta un concepto o una nota de coche es que nadie la ha escrito todavía, nunca que dé igual, y todo lo que añada de conocimiento general viene etiquetado como tal. Hay valores que en un coche concreto son lecturas y no mandos — eso lo dice primero. Explicar nunca te propone valores; eso es otra capacidad — Setups IA, justo debajo.
¿Prefieres leer a preguntar? El mismo corpus está publicado, gratis y sin atarse a un simulador, en la Guía de Setup.
Setups IA
Tu bóveda privada de setups, y el ingeniero que cambia lo que hay dentro. Explicar un parámetro es la sección de arriba; proponer valores es esta.
Todas estas herramientas requieren un plan Plus o Ultra. Documentación completa de producto: Setups IA.
La bóveda
| Herramienta | Descripción |
|---|---|
| listCarSetups | Lista tus setups como filas resumen — simulador, coche, circuito, tipo, etiquetas y estado |
| getCarSetup | Un setup con su linaje completo de versiones, los hitos de la conversación y los parámetros parseados de cada versión |
| createCarSetup | Crea un setup y su v1 desde un archivo .svm completo (solo Le Mans Ultimate) |
| addSetupVersion | Añade una versión desde otro .svm completo — para cuando lo retocaste en el simulador y lo volviste a exportar (solo LMU) |
Un linaje nunca mezcla canales de parámetros. Una versión .svm no se puede añadir
a un setup construido desde un .htm de iRacing, y el ingeniero abre un setup
aparte en vez de fingir que los dos son comparables.
Entrevista de Setup
La entrevista es solo de Le Mans Ultimate y requiere un .svm propio existente.
Las referencias protegidas son evidencia interna para movimientos relativos; no
se descargan, nombran ni copian a la bóveda del piloto. Recorrido completo:
Entrevista de Setup.
| Herramienta | Descripción |
|---|---|
| buildSetupFromInterview | Deriva una hija de una versión propia de LMU mediante una celda de origen explícita y cuatro respuestas de destino; solo devuelve movimientos relativos y descartes |
| listReferenceSetups | Comprueba la cobertura interna de evidencia para una variante y celda exactas sin exponer procedencia de fuentes |
| reportReferenceMiss | Registra que pediste una base que no tenemos, para que la curación sepa qué recoger a continuación — esta acepta también peticiones de iRacing, aunque no podamos servirlas |
La entrevista exige celdas exactas de origen y destino para la misma variante de coche verificada. Nunca sustituye otro coche ni cae en silencio a una condición o sesión vecina.
Cambiar un setup
| Herramienta | Descripción |
|---|---|
| remixSetup | Deriva una versión nueva cambiando parámetros concretos — la acción central de Setups IA |
| getCarParamSpace | El espacio de parámetros observado por Braking Lab para un coche, como referencia previa a proponer valores |
Un remix solo puede tocar parámetros que tu garaje marca como ajustables; un cambio
sobre cualquier otro se rechaza y no se escribe ninguna versión.
getCarParamSpace no es autoritativo y lo dice: los archivos subidos son
editables, las observaciones están incompletas, y un valor no visto puede ser
perfectamente legal. Cada fila lleva cuántas observaciones la respaldan, así que
una lectura de un solo archivo no puede pasar por regla.
Con qué condujiste de verdad
| Herramienta | Descripción |
|---|---|
| getSetupTelemetryContext | Un contexto de telemetría acotado para un setup y una sesión, con la identidad de simulador y coche comprobada, antes de proponer un remix |
| confirmSetupUsage | Confirma que un uso de setup sugerido corresponde a su sesión capturada, o corrígelo a otra versión |
| previewSetupAssociation | Valida una asociación setup/sesión propuesta y devuelve una vista previa, sin escribir evidencia |
| commitSetupAssociation | Confirma exactamente esa vista previa, después de que tú la apruebes |
| retireSetupAssociation | Retira un uso que ya no sostienes; el histórico y las evaluaciones enlazadas se conservan |
Braking Lab te pide confirmación a través de tu cliente MCP justo antes de escribir una asociación. Un booleano que ponga el agente nunca vale como tu consentimiento, y el ingeniero no puede previsualizar y confirmar en el mismo turno.
Evidencia
| Herramienta | Descripción |
|---|---|
| recordSetupEvaluation | Añade tu veredicto subjetivo para un uso confirmado — el pulgar principal, más una comparación relativa opcional contra otra tanda del mismo setup |
| getSetupExperimentHistory | Tu histórico de experimentos de un setup: procedencia de versiones, usos confirmados, evaluaciones activas y resultados de telemetría |
| compareSetupUsages | Compara dos usos confirmados desde la telemetría capturada — ritmo, consistencia, tamaños de muestra, condiciones, factores de confusión y fuerza de la evidencia |
La comparación informa de prueba menos base y ahí se para. No declara un ganador, porque dos tandas no establecen causalidad — mira Setups y tus sesiones.
Prompts de ejemplo:
- “Constrúyeme un setup de carrera en mojado para el Ferrari 296 LMGT3 en Spa.”
- “Coge mi setup de clasificación de Monza y cálmame la entrada un clic.”
- “¿Cuál de mis dos tandas en Baréin fue mejor de verdad, y por cuánto?”
Clasificación
Rankings de rendimiento público.
| Herramienta | Descripción |
|---|---|
| getDesktopLeaderboard | Clasificación pública de sesiones subidas ordenadas por tiempo de vuelta — cada entrada lleva un ID de vuelta que puedes pasar a compareTraces para duelar esa vuelta |
Ayuda y Documentación
Información de auto-servicio.
| Herramienta | Descripción |
|---|---|
| whoami | Con qué piloto está conectado el ingeniero, su plan, y cuántos informes de IA le quedan este mes |
| getCapabilities | Resumen estructurado de todo lo que puede hacer el Race Engineer |
| getDocumentation | Documentación de funcionalidades del app con enlaces |
| getFunctionSchema | Introspecciona el JSON Schema completo de cualquier función antes de llamarla |
Siguientes pasos
- Ejemplos — Mira conversaciones de ejemplo de principio a fin
- Coaching — Aprende a obtener el mejor análisis de coaching
- Preparación de Carreras — Usa el engineer para preparar carreras