Skip to main content
Glama
Reach120 MCP Server

Reach120 MCP Server

Official
by reach120

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

Herramienta

Qué hace

Costo

list_practice_prompts

Lista las indicaciones de práctica de escritura, con el id utilizado para calificar contra una

Lee filas almacenadas, no ejecuta ningún modelo

get_practice_prompt

Obtiene una indicación con su escenario completo o contexto de discusión

Lee una fila almacenada, no ejecuta ningún modelo

score_writing_response

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

Variable

Requerido

Predeterminado

Significado

REACH120_API_KEY

sí

—

Tu clave de API de Reach120. Las herramientas se niegan sin ella.

REACH120_API_BASE_URL

no

https://www.reach120.com

Apunta a otro despliegue.

REACH120_API_TIMEOUT_MS

no

ver readConfig en src/api.ts

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

Available Tools

3 tools
get_practice_promptFetch one TOEFL Writing practice promptA
Read-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 promptsA
Read-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

    A4.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers