diario

Documentation

Diario is a remote MCP server. Your assistant is the tutor; Diario supplies the material and remembers what you got wrong.

Set up

You need an account on this Diario and an assistant that supports remote MCP connectors.

Claude

  1. Open Settings, then Connectors, then Add custom connector.
  2. Paste https://diario-ai.com/mcp and save.
  3. Choose Connect. A Diario page opens: sign in and choose Allow.
  4. Start a chat and say «empecemos la sesión de hoy».

If you installed the Diario plugin, the connector appears on the plugin's Connectors tab and the daily session skill loads with it.

Claude Code

claude mcp add --transport http diario https://diario-ai.com/mcp

Muse

Add Diario from Settings, then Connectors, and sign in when asked. In Muse Code, add the server to ~/.config/muse/settings.json and run muse mcp login diario:

{
  "mcp_servers": {
    "diario": { "transport": "streamable_http", "url": "https://diario-ai.com/mcp" }
  }
}

Clients that take a key

Create a personal access token on your dashboard and send it as Authorization: Bearer <token>.

Signing in and permissions

Diario uses OAuth 2.1 with PKCE. Clients register themselves (dynamic client registration) or use a client the operator has pre-registered. There are two permissions:

Discovery documents: /.well-known/oauth-protected-resource/mcp and /.well-known/oauth-authorization-server. Transport: Streamable HTTP, stateless, POST only.

Things to say

  1. «Empecemos la sesión de hoy.» Runs the whole session: review, a reading with a writing task, a dictation clip, sentence drills and a wrap-up.
  2. «Dame un dictado coloquial de México.» Fetches a native-speed clip and scores what you type, word by word.
  3. «¿En qué fallo más este mes?» Shows your error heatmap, trends and the patterns that keep recurring.
  4. «Compara lo que escribí hoy con lo de hace un mes.» Pulls your earlier writing next to today's.
  5. «Quiero sesiones de 30 minutos y más español de Argentina.» Updates your settings.

Tools

Read tools change nothing. Write tools store or change your own practice data. The one sensitive write is irreversible and needs an exact confirmation phrase.

ToolTypeWhat it does
start_sessionWriteStart today's practice session, or resume it if one is already open. Creates the session record and adds today's new colloquial expressions and interest-lane vocabulary to the review deck. Returns the plan, today's register for reading and listening, any interest lane in play (such as tennis) with its new vocabulary, the colloquial variety of the day, streak, weak spots, due card count and how much unread content is available.
get_due_cardsReadList the spaced-repetition cards due now: reviews first, then new cards. Each card has a front (the question) and a back (the answer, for grading). Cards come from past corrections, colloquial expressions, interest-lane vocabulary and words missed in dictation.
grade_cardsWriteSave the results of reviewing cards and reschedule each one. Ratings: 1 did not know, 2 hard, 3 good, 4 easy. Accepts many cards in one call.
get_readingReadReturn an unread text for reading and writing practice, with suggested writing prompts. Formal texts are press articles (El País and similar); colloquial texts are excerpts of real conversation from Spanish, Mexican or Argentine podcasts, or informal writing; an interest lane such as tennis has its own press and talk. Defaults to today's reading lane. When partial is true only a summary is stored and the learner should read the piece at its url.
submit_writingWriteSave a piece the learner wrote (or said aloud) together with its correction, score and tagged errors. Errors of severity 2 or 3 become review cards. Use it after correcting the learner's text.
get_listening_clipReadReturn a short clip of native-speed speech from a real podcast for dictation, as a link to an audio player page. The transcript is not included. Defaults to today's listening lane and the learner's tier (1 easiest, 5 hardest). Pass clip_id to get the same clip again for another attempt.
submit_dictationWriteScore what the learner typed against the clip transcript and save the attempt. Returns accuracy, a word-by-word diff, missed words and tier progress. The transcript is returned only from the second attempt, or at 90% accuracy or better.
get_speaking_transcriptReadReturn the transcript of the learner's oldest unreviewed live conversation from the speaking page, with their turns and the conversation partner's. After correcting it, save the correction with submit_writing using prompt_type conversation and the speech_id. Also returns the address of the live speaking page.
get_formulation_drillsReadReturn short sentence-building drills chosen for the learner's recent error categories, plus colloquial situations in today's variety (Spain, Mexico or Argentina) and, on a day with an interest lane, two drills in its vocabulary. Each drill has a prompt and the structure a good answer should use.
submit_formulationsWriteSave the learner's answers to sentence-building drills, with whether each was accepted and any tagged errors. Accepts all drills of a round in one call.
get_progressReadReturn the learner's progress over a window of days: streak, XP and level, sessions, writing scores, dictation accuracy and tier, drill results, deck size and an error heatmap with trends and fossilised patterns.
list_past_writingsReadList the learner's earlier writing with the original and corrected text, newest first. Useful for comparing today's writing with older pieces.
get_preferencesReadReturn the learner's settings: time zone, session length, formal/colloquial mix, colloquial varieties, interest lanes, explicit-content and speaking switches, new expressions per session and listening tier.
update_preferencesWriteChange the learner's settings. Only the fields provided are changed.
end_sessionWriteClose the practice session and store a short summary. Returns XP earned, streak, level and tomorrow's focus.
list_sourcesReadList the publications and podcasts Diario draws content from, with their register, region, interest lane and when each last produced new content.
delete_my_dataSensitive writePermanently delete everything the learner has produced in Diario: writings, corrections, review deck, dictations, drill results, sessions, streak and XP. The account and its settings remain. This cannot be undone.

Errors come back as readable messages that say what to change. Tool results stay well under 25,000 tokens; texts are trimmed to about 900 words by default.

Error categories

Every correction is filed under one of these, which is how Diario finds the patterns worth drilling.

CategoryCovers
verb_moodSubjuntivo / indicativo. Mood choice.
verb_tenseTiempos verbales. Preterite vs imperfect, pluperfect, future of probability.
verb_agreementConcordancia verbal. Person and number.
ser_estarSer / estar
prepositionPreposiciones. por/para, personal a, fixed verb + preposition.
gender_numberGénero y número. Noun gender, article and adjective agreement.
pronounPronombres. Object pronouns, se constructions, clitic placement.
articleArtículos. Missing or extra article (la gente, los lunes).
word_orderOrden de palabras. Adjective and adverb position.
lexicalLéxico. False friends, anglicisms, wrong collocation.
connector_discourseConectores. sin embargo, por lo tanto, en cuanto a: missing or misused.
orthographyOrtografía. Accent marks, b/v, h, ll/y, capitalisation.
punctuationPuntuación. ¿¡, commas, dialogue dashes.
relative_clauseOraciones de relativo. que/quien/cuyo/el cual, preposition + relative.
registerRegistro. Wrong level of formality, or regional features mixed together.
naturalnessNaturalidad. Grammatical, but not how a native speaker would say it.

Where the material comes from

Formal texts are press articles; colloquial material comes from unscripted podcasts in Spain, Mexico and Argentina and from informal writing. If you follow tennis, turn on the tennis lane and it joins the rotation with its own press coverage and podcasts. Every text and clip links back to its source.

SourceKindRegisterRegion
El País · OpiniónReadingformalEspaña
El País · CulturaReadingformalEspaña
El País · SociedadReadingformalEspaña
El País · CienciaReadingformalEspaña
The Conversation (España)ReadingformalEspaña
BBC News MundoReadingformalLatinoamérica
El Deforma (satire)ReadingcolloquialMéxico
El País · TenisReadingformalEspaña
Marca · TenisReadingformalEspaña
AS · TenisReadingformalEspaña
Hoy en EL PAÍSListeningformalEspaña
Un tema Al díaListeningformalEspaña
El hiloListeningformalLatinoamérica
Radio AmbulanteListeningformalLatinoamérica
Nadie Sabe NadaListeningcolloquialEspaña
La Ruina (strong language)ListeningcolloquialEspaña
La Cotorrisa (strong language)ListeningcolloquialMéxico
Leyendas Legendarias (strong language)ListeningcolloquialMéxico
Hoy Trasnoche (strong language)ListeningcolloquialArgentina
Concha Podcast (strong language)ListeningcolloquialArgentina
El RestoListeningcolloquialEspaña
Sexto SetListeningcolloquialMéxico
3IGUALESListeningcolloquialArgentina

How Diario fetches it

Once a day Diario reads each publisher's public feed, identifying itself as DiarioBot/1.0 (personal language-study reader; respects robots.txt). It checks robots.txt before fetching any article page; where a publisher disallows automated readers, Diario keeps only the feed's own summary and sends you to the article through its link. Listening clips are 15 to 60 second excerpts cut from public podcast episodes, kept for a limited time and always shown with the show, the episode and a link to the full recording.

Publishers who want a source removed can write to the support address below.

Practising on the web

Today's practice is the reading and writing part of a session without an assistant: the texts dated today to pick from (which you can narrow to one source), a choice of writing tasks, and a box to write in. A row of the last fourteen days shows which you have done; open any earlier day to do it with that day's own texts. The page collects new texts by itself and says when it last did. Your text comes back corrected, with each mistake marked and explained, and the corrections join the same error history and review deck your assistant uses. If a phrase in the text stops you, select it and choose Explain: a note gives it in English and says what it means there.

Live speaking practice

The speaking page runs a short spoken conversation in Spanish. Audio goes from your browser directly to OpenAI; Diario keeps only the text so your tutor can correct it with get_speaking_transcript.

Support

Contact the person who runs this Diario. See also the privacy policy and terms.