Conecta tu asistente
Connect your assistant
Para asistentes y desarrolladoresFor assistants and developers
Tu español desde Claude o ChatGPT
Your Spanish from Claude or ChatGPT
Tu asistente puede practicar español contigo si conoce tu nivel, tus errores y tus frases. Añade este servidor MCP, entra con tu cuenta y tendrá tu nivel, tus errores y tus frases en cada chat, en cualquier dispositivo. Di «¿Qué sabes de mi español?» y empieza.Your assistant can practise Spanish with you if it knows your level, your errors and your phrases. Add this MCP server, sign in with your account and it will have your level, your errors and your phrases in every chat, on any device. Say “What do you know about my Spanish?” and start.
https://learnspeakrepeat.com/mcpClaude: Ajustes → Conectores → Añadir conector personalizado → pega la dirección.Claude: Settings → Connectors → Add custom connector → paste the address.
ChatGPT: activa el modo desarrollador y añade la dirección como app (conector MCP).ChatGPT: enable developer mode and add the address as an app (MCP connector).
La prueba de nivel y el repaso son gratis con tu cuenta; la sesión diaria necesita un plan. Sin tarjeta para empezar.The level test and the review are free with your account; the daily session needs a plan. Without a card to start.
Gratis, con tu cuenta
Free, with your account
- La prueba de nivel adaptativa (A1–C2) en el propio chat, en unos diez minutos.The adaptive level test (A1–C2) in the chat itself, in some ten minutes.
- Tu modelo de alumno: nivel con mapa de temas, destrezas medidas, diario de errores.Your learner model: level with a topic map, measured skills, error diary.
- Tu mazo de frases con repetición espaciada: el asistente lo lee, lo amplía y te lo repasa.Your spaced-repetition phrase deck: the assistant reads it, adds to it and drills you on it.
- Sin plan, el servidor corrige hasta 60 respuestas de repaso al día; después valoras tú.Without a plan, the server grades up to 60 review answers a day; after that you rate yourself.
Con plan
With a plan
La sesión diaria con sus capítulos, corrección en el servidor, pronunciación medida palabra por palabra y conversación en directo con un compañero de voz. Básico 19 €/mes (120 minutos de voz), Intensivo 39 €/mes (360). El progreso es el mismo en el chat, en el sitio y en cualquier dispositivo.The daily session with its chapters, correction on the server, pronunciation measured word by word and live conversation with a voice partner. Básico €19/month (120 voice minutes), Intensivo €39/month (360). Progress is the same in the chat, on the site and on any device.
Autorización
Authorization
OAuth 2.1 con PKCE y registro dinámico de clientes. Hay un solo permiso: sesion. Apruebas la conexión en /conectar. Los tokens duran una hora y se renuevan. Lo desconectas desde el chat.OAuth 2.1 with PKCE and dynamic client registration. There is only one permission: sesion. You approve the connection at /conectar. Tokens last one hour and renew. You disconnect it from the chat.
Versiones y retirada
Versioning and deprecation
La API para máquinas está en la versión 1; las solicitudes MCP usan la cabecera MCP-Protocol-Version para indicar la revisión del protocolo, y las herramientas del servidor se amplían de forma compatible. Un cambio incompatible llega como una nueva versión; la anterior seguirá funcionando al menos 90 días y, durante ese periodo, sus respuestas incluirán las cabeceras Deprecation y Sunset (RFC 9745 / RFC 8594) con un enlace a esta página.The machine API is at version 1; MCP requests use the MCP-Protocol-Version header for protocol revisions, and the server tools evolve additively. A breaking change ships as a new version; the previous one keeps working for at least 90 days, and its responses carry Deprecation and Sunset headers (RFC 9745 / RFC 8594) with a link to this page in the meantime.
Herramientas
Tools
get_learner: tu modelo de alumno y el siguiente paso; empieza aquíyour learner model and the next step; start hereget_course: tu capítulo, tu nivel y los siguientesyour chapter, your level and the next onesstart_placement: empieza la prueba de nivel en el chatstarts the level test in the chatanswer_placement: envía tu respuesta a una pregunta de la pruebasends your answer to a test questionshow_placement_picture: la tarjeta con la imagen y las opciones de una pregunta de la pruebathe card with the picture and the options of a test questionrecord_placement: la tarjeta para escuchar, hablar o leer en voz alta en la pruebathe card to listen, speak or read aloud in the testfinish_placement: calcula tu nivel y lo guarda en tu cuentaworks out your level and saves it to your accountget_review: tus tarjetas pendientes, sin respuestasyour due cards, without answersreview_card: corrige tu respuesta a una tarjeta y la reprogramagrades your answer to a card and reschedules itsave_phrase: guarda una frase en tu mazosaves a phrase to your deckget_today: el plan de hoy (con plan)today’s plan (with a plan)get_block: el material de un bloque, sin respuestasthe material of a block, without answerscheck_exercise: corrige una respuestagrades an answerstart_recording: la tarjeta para escuchar, grabar o llamar por voz; o un enlacethe card to listen, record or call by voice; or a linkget_recording: lee el resultado de una grabaciónreads the result of a recordingcheck_dictation: corrige un dictadogrades a dictationfinish_block: marca un bloque como hechomarks a block as donelog_practice: analiza una conversación que has tenido con el asistente (con plan)analyses a conversation you had with the assistant (with a plan)
Las respuestas nunca salen del servidor antes de que respondas; el servidor corrige y puntúa. Lo que el asistente entrega con log_practice entra en tu diario; solo se analizan tus frases.The answers never leave the server before you answer; the server corrects and scores. What the assistant hands over with log_practice goes into your diary; only your lines are analysed.
Límites
Limits
MCP: 120 peticiones por minuto por alumno. Enlaces de grabación: 60 peticiones por minuto por enlace. Sin plan: 60 correcciones de repaso con el modelo al día y 30 frases guardadas al día; log_practice: 6 al día. Cada respuesta lleva RateLimit-Policy; al pasarte, 429 con Retry-After.MCP: 120 requests per minute per learner. Recording links: 60 requests per minute per link. Without a plan: 60 model review gradings a day and 30 saved phrases a day; log_practice: 6 a day. Every response carries RateLimit-Policy; when you exceed it, 429 with Retry-After.
Ejemplo
Example
Lo que recibe el asistente, antes de conectar nada: una alumna de ejemplo y una noche de 40 minutos.What the assistant receives, before connecting anything: an example learner and a 40-minute evening.
get_learner: una alumna de ejemplo
get_learner: an example learner
Datos inventados con la forma real de la respuesta. Ana tiene plan, ha dominado su primer capítulo de B1.1 y esta noche abre el segundo (sessions: 0); por eso nextStep lleva a get_today. Sin plan, voice sería null y nextStep llevaría al repaso, que sigue siendo gratis.Invented data, with the real shape of the response. Ana has a plan, has mastered her first B1.1 chapter and tonight opens the second (sessions: 0); that is why nextStep leads to get_today. Without a plan, voice would be null and nextStep would lead to the review, which stays free.
{
"onboarded": true,
"access": {
"paid": true,
"tier": "basico",
"paidUntil": "2026-10-28T19:12:00.000Z",
"upgradeUrl": "https://learnspeakrepeat.com/precio"
},
"nextStep": {
"tool": "get_today",
"es": "Vamos con la sesión de hoy.",
"en": "Open today’s session."
},
"language": {
"l1": "en",
"showL1Hints": true,
"register": "tu"
},
"level": {
"band": "B1",
"subLevel": "B1.1",
"level": "B1.1",
"nameEs": "B1.1 · Construir la base oral"
},
"topicMap": {
"known": [
"Ser y estar: identidad y estado; hay para existir · Ser and estar: identity and state; hay for existing"
],
"partial": [
"Llevar + tiempo + gerundio; desde, desde hace, hace… que · Llevar + time + gerund; since, since ago, it makes… that (= it has been … since)",
"Indefinido e imperfecto en la narración: acciones que avanzan la historia frente a contexto y hábitos · Indefinido and imperfect in narration: actions that advance the story versus context and habits"
],
"unknown": [
"Imperfecto de subjuntivo: formación desde la tercera persona del plural del indefinido (fueran, tuviera, hiciera) · Imperfect subjunctive: formation from the third person plural of the indefinido (fueran, tuviera, hiciera)"
],
"unchecked": []
},
"skills": {
"speaking_fluency": {
"score": 48,
"measured": true
},
"speaking_accuracy": {
"score": 55,
"measured": true
},
"listening": {
"score": 40,
"measured": false
},
"grammar": {
"score": 62,
"measured": true
},
"vocabulary": {
"score": 40,
"measured": false
},
"pronunciation": {
"score": 60,
"measured": true
}
},
"weakSkills": [
"speaking_fluency",
"speaking_accuracy"
],
"chapter": {
"id": "b1-1-02",
"titleEs": "Una anécdota de verdad",
"goalEs": "Contar una anécdota completa con gracia: situar la escena, narrar lo que pasó, decir cómo te sentiste y rematar con un final.",
"level": "B1.1",
"status": "available",
"mastery": 0,
"sessions": 0,
"chunks": [
"¿Sabes qué me pasó el otro día?",
"Resulta que…",
"Estaba… cuando de repente…",
"En ese momento…",
"Total que…",
"Al final…",
"No te lo vas a creer.",
"Me quedé de piedra."
]
},
"nextChapter": {
"id": "b1-1-03",
"titleEs": "Mi trabajo, mi día a día"
},
"errors": [
{
"category": "tiempos_pasado",
"original": "Ayer fuistes al cine.",
"corrected": "Ayer fuiste al cine.",
"explanationEs": "La forma «tú» del indefinido no lleva -s final.",
"l1Hint": "The tú form of the preterite has no final -s.",
"occurrences": 3,
"lastSeenAt": "2026-10-04T19:42:00.000Z"
},
{
"category": "ser_estar",
"original": "Estoy profesora.",
"corrected": "Soy profesora.",
"explanationEs": "Para la profesión se usa «ser».",
"l1Hint": "For the profession one uses \"ser\".",
"occurrences": 2,
"lastSeenAt": "2026-10-02T20:05:00.000Z"
}
],
"cards": {
"due": 7,
"total": 64
},
"practice": {
"streak": 4,
"totalMinutes": 310,
"speakingMinutes": 42,
"lastActiveAt": "2026-10-05T20:10:00.000Z",
"wpmLast": 71
},
"voice": {
"remainingMinutes": 97,
"resetsAt": "2026-10-28T19:12:00.000Z"
},
"interests": [
"viajes",
"cocina"
],
"dailyMinutes": 40,
"today": null
}get_today: una noche de 40 minutos
get_today: a 40-minute evening
Con un plan, get_today devuelve los bloques con sus minutos. Así reparte el servidor los 40 minutos de Ana en la primera noche de un capítulo (en las siguientes, la explicación desaparece y sus minutos pasan a hablar). Cada bloque empieza con get_block y termina con finish_block: así avanzan la racha y el capítulo.With a plan, get_today returns the blocks with their minutes. This is how the server splits Ana’s 40 minutes on the first evening of a chapter (on the following ones, the explanation disappears and its minutes go to speaking). Every block begins with get_block and ends with finish_block: that is how the streak and the chapter advance.
- 8min
get_block · review_card · finish_blockRepasoReviewLas siete tarjetas pendientes, una a una: el asistente lee la pista, la alumna contesta, el servidor corrige.The seven due cards, one by one: the assistant reads the cue, the learner answers, the server grades. - 5min
get_block · finish_blockExplicaciónExplanationLa explicación corta y el diálogo modelo del capítulo.The short explanation and the model dialogue of the chapter. - 10min
get_block · check_exercise · finish_blockEjerciciosExercisesUnos siete ejercicios; la alumna responde antes de ver nada.About seven exercises; the learner answers before seeing anything. - 7min
get_block · start_recording · check_dictation · get_recording · finish_blockEscuchaListeningUn dictado y dos frases para repetir detrás de la voz.One dictation and two sentences to repeat after the voice. - 8min
get_block · start_recording · get_recording · finish_blockHablarSpeakingUn monólogo de hasta dos minutos (la primera ronda del 4/3/2 a nivel B1) o una escena en directo, en la tarjeta del chat o por enlace.A monologue of up to two minutes (the first round of the 4/3/2 at B1 level) or a live scene, in the chat card or by link. - 2min
get_block · finish_blockCierreClosingEl resumen del día: los errores de hoy, ya convertidos en tarjetas para mañana.The day’s summary: today’s errors, already turned into cards for tomorrow.
Así lo lleva el asistente
This is how the assistant runs it
get_today · get_blockBuenas noches, Ana. Hoy, 40 minutos y siete tarjetas pendientes. Empezamos: llevas veinte minutos en la parada y tu amiga llega. ¿Qué le dices?Good evening, Ana. Today, 40 minutes and seven due cards. We begin: you have been twenty minutes at the stop and your friend arrives. What do you say to her?- Llevo un rato esperando.I carry a while waiting (= I have been waiting for a while).
review_cardCorrecto. Próximo repaso dentro de 8 días. Siguiente tarjeta…Correct. Next review in 8 days. Next card…finish_block · get_block · start_recordingBloque de hablar. Hoy toca un monólogo: cuéntame una anécdota de verdad en dos minutos como mucho. Pulsa para grabar.Speaking block. Today it is the turn of a monologue: tell me a real anecdote in two minutes at most. Press to record.- Listo.Done.
get_recording · finish_block82 palabras por minuto. Una cosa: «fuistes» → «fuiste». Ese error ya está en tu diario y sale mañana en el repaso. Bloque hecho; vamos al cierre.82 words per minute. One thing: «fuistes» → «fuiste». That error is already in your diary and comes up tomorrow in the review. Block done; we go to the closing.
Protocolo
Protocol
curl https://learnspeakrepeat.com/.well-known/oauth-protected-resource/mcp{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-assistant","version":"1"}}}Enlaces
Links
