Reach120 MCP Server
OfficialServidor MCP de Reach120
Un servidor MCP que proporciona a un agente de IA una ruta gobernada hacia la API de práctica TOEFL iBT de Reach120: obtener indicaciones de práctica de escritura y calificar la respuesta escrita de un estudiante.
Reach120 es una plataforma de práctica independiente. No está afiliada, respaldada ni administrada por ETS. TOEFL® es una marca registrada de ETS. Reach120 no está afiliada, respaldada ni aprobada por ETS.
Herramientas
Herramienta | Qué hace | Costo |
| Lista las indicaciones de práctica de escritura, con el id utilizado para calificar contra una | Lee filas almacenadas, no ejecuta ningún modelo |
| Obtiene una indicación con su escenario completo o contexto de discusión | Lee una fila almacenada, no ejecuta ningún modelo |
| Califica una respuesta escrita, devolviendo una puntuación de práctica automatizada y una breve justificación | Ejecuta el calificador; medido contra tu clave |
Related MCP server: agent-validator-mcp-server
Tú aportas la clave
Este servidor no lleva ninguna credencial. Reenvía la clave que colocas en REACH120_API_KEY y devuelve la respuesta de la API sin cambios.
Eso es una decisión de diseño, no una omisión. Cada límite que importa vive en el lado del servidor de la API y se evalúa en cada llamada: una ventana de solicitudes por clave, una asignación diaria de calificación por clave y un límite de gasto a nivel de servicio. Un cliente que impusiera sus propios límites solo los impondría a las personas que eligieran seguir usando el cliente, por lo que este no impone ninguno y no puede ser una forma de evadirlos. Elimina este paquete y llama al endpoint directamente y obtendrás rechazos idénticos.
No existe una ruta de calificación sin autenticación. Un agente sin clave recibe un rechazo que indica de dónde proviene una clave, y no se envía nada.
Solicita una clave y lee la política completa de límites, códigos de error y versiones en https://www.reach120.com/developers.
Instalación
Este paquete no está publicado en npm. La ruta de instalación es este repositorio, y es la única: @reach120/mcp-server no se resuelve en el registro público de npm y ningún otro nombre de paquete lo reemplaza.
npx -y github:reach120/reach120-mcpnpm compila el TypeScript durante esa instalación mediante el script prepare, por lo que no hay un paso de compilación separado.
O clónalo y ejecútalo desde el código fuente:
git clone https://github.com/reach120/reach120-mcp.git
cd reach120-mcp
npm install
npm run build
node dist/index.jsConfiguración
Claude Desktop (claude_desktop_config.json), Claude Code, o cualquier cliente MCP que hable stdio:
{
"mcpServers": {
"reach120": {
"command": "npx",
"args": ["-y", "github:reach120/reach120-mcp"],
"env": {
"REACH120_API_KEY": "r120_live_your_key_here"
}
}
}
}Variable | Requerido | Predeterminado | Significado |
| sí | — | Tu clave de API de Reach120. Las herramientas se niegan sin ella. |
| no |
| Apunta a otro despliegue. |
| no | ver | Tiempo de espera por solicitud, en milisegundos. |
Cómo se ve un rechazo
Los límites se rechazan con un código legible por máquina en lugar de degradarse. Una llamada que alcanza la asignación diaria de la clave no se califica silenciosamente con un motor más barato y se devuelve como si fuera el motor que pediste: el código nombra lo que sucedió, y la tabla de errores en /developers dice qué significa cada uno.
Verifícalo localmente
npm install
npm run build
npm run verifynpm run verify inicia el servidor compilado a través de stdio, completa un apretón de manos MCP real con el cliente SDK, imprime las herramientas anunciadas y llama a una herramienta sin clave para mostrar la ruta de rechazo.
Las puntuaciones son comentarios de práctica
score_writing_response devuelve comentarios de práctica automatizados producidos por Reach120.
No es una puntuación de ETS y no se informa en la escala oficial. Este README deliberadamente no nombra la escala en la que está el número: ese hecho se publica junto a una limitación obligatoria que requiere el registro de reclamaciones, que una página de paquete no puede mostrar. La forma de la respuesta está documentada en https://www.reach120.com/developers.
TOEFL® es una marca registrada de ETS. Reach120 no está afiliada, respaldada ni aprobada por ETS.
Licencia
MIT. Ver LICENSE.
Available Tools
3 toolsget_practice_promptFetch one TOEFL Writing practice promptARead-only
Fetch a single Writing practice prompt by its id, including the full scenario or discussion context a learner is asked to respond to. Reads a stored row and runs no model. TOEFL® is a registered trademark of ETS. Reach120 is not affiliated with, endorsed by, or approved by ETS.
Inputs: item_id (required).
list_practice_promptsList TOEFL Writing practice promptsARead-only
List Writing practice prompts from the Reach120 bank — the Write an Email task and the Writing for an Academic Discussion task. Returns each prompt with the id you pass to score_writing_response. Reads stored rows and runs no model, so it spends nothing against your daily scoring allowance, but it does count against your per-minute request window. TOEFL® is a registered trademark of ETS. Reach120 is not affiliated with, endorsed by, or approved by ETS.
Inputs: limit, offset, task_type.
score_writing_responseScore a TOEFL Writing responseA
Score a learner's written response to a TOEFL iBT Writing task and return an automated practice score with a short rationale. The response shape, the limits and the error codes are documented at https://www.reach120.com/developers. Supply either item_id from the prompt tools, or task_type plus the prompt inline for your own coursework. This call runs an AI scorer and is metered: it draws on the daily spend ceiling attached to your API key, and refuses with a machine-readable code rather than quietly scoring on a cheaper engine when a limit is reached. Reach120 is an independent practice platform. It is not affiliated with, endorsed by, or administered by ETS. TOEFL® is a registered trademark of ETS. Reach120 is not affiliated with, endorsed by, or approved by ETS.
Inputs: response (required), prompt, item_id, task_type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clear, distinct role: listing prompts, fetching a single prompt by id, and scoring a written response. The list/get pair follows a standard convention without meaningful overlap, and scoring is wholly separate.
All tool names follow a consistent verb_noun snake_case pattern: list_practice_prompts, get_practice_prompt, score_writing_response. The naming clearly communicates both the action and the target resource.
Three tools is well-scoped for this server's narrow purpose: browsing a fixed prompt bank and scoring responses. Each tool serves a distinct step in the workflow without redundancy.
The tool surface covers the full intended workflow: discover prompts, retrieve full prompt details, and score a response using either a bank item or inline task type. Since the prompt bank is read-only, no create/update/delete tools are necessary.
Related MCP Connectors
Turn any task into the right API calls: discover, evaluate, and integrate public APIs.
Discover, compare, route, and execute machine-accessible capabilities for AI agents.
660+ data tools for agents: TikTok, Douyin, Instagram, YouTube, X, weather, GitHub. Pay per call.
Access Pollinations models and API capabilities through agent tools.
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceEnables LLMs to convert documents to Google Forms, edit questions, list and publish forms, and run AI form assistant tools through the Formswrite API.MIT- AlicenseAqualityDmaintenanceEnables testing and validation of APIs for AI agent compatibility, providing scores, grades, and actionable recommendations.321 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to discover, search, and call any REST API described by an OpenAPI or Swagger document. Supports multiple API endpoints with authentication and parameter handling.14 npmMIT
- AlicenseAqualityDmaintenanceEnables AI agents to create and edit Google Docs and draft Gmail emails through natural language.7ISC