Servidor 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

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-mcp

npm 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.js

Configuració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"
      }
    }
  }
}

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 verify

npm 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.