Referencia de herramientas
Las 29 herramientas MCP agrupadas por permiso, con lo que hace cada una y lo que requiere.
Veintinueve herramientas, agrupadas por el permiso que las desbloquea. Esta tabla sirve para decidir qué conceder: los parámetros los lee tu asistente por su cuenta, así que aquí no se repiten.
Lee los grupos de permisos antes de conceder nada: el nivel de escritura de un grupo siempre incluye la eliminación, y la eliminación va en cascada.
Todas las herramientas que enumeran cosas devuelven una página a la vez —20 elementos por defecto, 100 como máximo—, así que recorrer un Notebase grande cuesta varias llamadas.
Información de la cuenta
Solo lectura. Este grupo no tiene nivel de escritura.
| Herramienta | Qué hace | Necesita |
|---|---|---|
whoami | Indica con qué cuenta de Read Frog está autorizada la conexión. El correo electrónico solo se incluye si la conexión tiene además el permiso de correo electrónico. | account lectura |
Notebases y campos
| Herramienta | Qué hace | Necesita |
|---|---|---|
list_notebases | Enumera los Notebases que te pertenecen. | notebases lectura |
get_notebase_schema | Lee el nombre y las definiciones de campo de un Notebase, incluidos los IDs de campo que se usan como claves al escribir notas. No devuelve contenido de notas. | notebases lectura |
create_notebase | Crea un Notebase vacío, opcionalmente con sus campos iniciales. Las notas se añaden aparte. | notebases escritura |
rename_notebase | Renombra un Notebase sin tocar sus ajustes de estudio. | notebases escritura |
delete_notebase | Elimina permanentemente un Notebase junto con sus campos, notas, plantillas, tarjetas y registros de repaso. | notebases escritura |
create_notebase_field | Añade un campo a un Notebase y devuelve su ID. | notebases escritura |
update_notebase_field | Renombra un campo o cambia su configuración; el tipo no se puede cambiar. Quitar una opción de selección borra ese valor de todas las notas. | notebases escritura |
delete_notebase_field | Elimina un campo y borra sus valores de todas las notas. Los campos primarios, y los campos a los que se refiere una plantilla, no se pueden eliminar. | notebases escritura |
Contenido de las notas
| Herramienta | Qué hace | Necesita |
|---|---|---|
list_notes | Recorre notas, o busca dentro de un Notebase. La búsqueda es una subcadena literal, sin distinguir mayúsculas, de dos o más caracteres, y solo coincide con campos de texto. | notes lectura |
get_note | Lee los valores de los campos de una nota más la marca de tiempo que protege las ediciones posteriores. | notes lectura |
create_notes | Crea de 1 a 50 notas de una vez en un mismo Notebase, de forma atómica. Las plantillas existentes las convierten en tarjetas al momento. | notes escritura |
update_note | Fusiona valores nuevos en una nota y conserva los campos que no menciona; null borra uno. Falla en lugar de sobrescribir si la nota cambió desde que se leyó. | notes escritura |
delete_note | Elimina permanentemente una nota junto con las tarjetas generadas a partir de ella y sus registros de repaso. | notes escritura |
Plantillas de tarjeta
| Herramienta | Qué hace | Necesita |
|---|---|---|
list_card_templates | Enumera tus plantillas de tarjeta, opcionalmente dentro de un Notebase. | card_templates lectura |
get_card_template | Lee la definición completa de una plantilla y la marca de tiempo que protege las ediciones posteriores. | card_templates lectura |
create_card_template | Crea una plantilla a partir de IDs de campo existentes. Esto genera tarjetas para todas las notas que ya haya en el Notebase. | card_templates escritura |
update_card_template | Cambia el nombre o la definición de una plantilla. Las tarjetas renderizadas siguen la plantilla guardada. | card_templates escritura |
delete_card_template | Elimina permanentemente una plantilla junto con las tarjetas que generó y sus registros de repaso. Las notas de origen se quedan. | card_templates escritura |
Tarjetas renderizadas
Una tarjeta es contenido de nota combinado con estado de programación, así que estas dos necesitan dos permisos de lectura a la vez.
| Herramienta | Qué hace | Necesita |
|---|---|---|
list_cards | Recorre tarjetas con su anverso y su reverso renderizados, sus IDs de origen y su estado de aprendizaje. Puede filtrar por Notebase, plantilla o estado de programación. | notes lectura + study lectura |
get_card | Lee una tarjeta de la misma manera. | notes lectura + study lectura |
Repasos e historial de aprendizaje
| Herramienta | Qué hace | Necesita |
|---|---|---|
get_study_stats | Lee los recuentos de la cola de estudio por Notebase para una zona horaria dada. No devuelve contenido de notas ni caras de tarjeta. | study lectura |
get_study_settings | Lee el límite diario de tarjetas nuevas, el límite diario de repasos y la retención deseada de un Notebase. No devuelve ni su nombre ni su contenido. | study lectura |
list_review_history | Lee tus registros de repaso, opcionalmente filtrados por Notebase o por tarjeta. El contenido de las notas y las caras de las tarjetas quedan excluidos. | study lectura |
update_study_settings | Cambia solo esos tres ajustes: límite diario de tarjetas nuevas, límite diario de repasos y retención deseada. | study escritura |
record_review | Envía una calificación para una tarjeta. FSRS la trata como un repaso real y actualiza la estabilidad, la dificultad y la fecha de vencimiento de la tarjeta. Requiere una zona horaria, porque decide a qué día de estudio pertenece el repaso. | study escritura |
undo_review | Deshace el último repaso admisible de una tarjeta y restaura el calendario que tenía antes. Requiere el ID de ese repaso, para que un reintento no pueda deshacer uno anterior. | study escritura |
set_card_suspended | Suspende una tarjeta, sacándola del estudio hasta que se reanude, o la reanuda. | study escritura |
set_card_buried | Omite una tarjeta, ocultándola durante el resto del día de estudio, o la devuelve. | study escritura |
Adónde ir después
- Recetas: en qué vale la pena combinar estas herramientas.
- Conectar un asistente: conceder, bajar y revocar permisos.