Reach120 MCP server

Ein MCP-Server, der einem KI-Agenten einen kontrollierten Zugang zur Reach120 TOEFL-iBT-Übungs-API bietet: Schreibübungs-Prompts abrufen und die schriftliche Antwort eines Lernenden bewerten.

Reach120 ist eine unabhängige Übungsplattform. Sie ist nicht mit ETS verbunden, von ETS unterstützt oder von ETS verwaltet. TOEFL® ist ein eingetragenes Warenzeichen von ETS. Reach120 ist nicht mit ETS verbunden, von ETS unterstützt oder von ETS genehmigt.

Tools

Related MCP server: agent-validator-mcp-server

Sie bringen den Schlüssel mit

Dieser Server enthält keine Anmeldedaten. Er leitet den Schlüssel, den Sie in REACH120_API_KEY platzieren, weiter und gibt die Antwort der API unverändert zurück.

Das ist eine Designentscheidung, keine Auslassung. Jede relevante Grenze liegt auf der Serverseite der API und wird bei jedem Aufruf ausgewertet – ein Anforderungsfenster pro Schlüssel, ein tägliches Bewertungskontingent pro Schlüssel und ein dienstweites Ausgabelimit. Ein Client, der eigene Grenzen durchsetzt, würde sie nur bei Personen durchsetzen, die sich dafür entscheiden, den Client weiterhin zu nutzen. Daher setzt dieser keine durch und kann keinen davon umgehen. Löschen Sie dieses Paket und rufen Sie den Endpunkt direkt auf, und Sie erhalten identische Ablehnungen.

Es gibt keinen unauthentifizierten Bewertungspfad. Ein Agent ohne Schlüssel erhält eine Ablehnung, die angibt, woher ein Schlüssel kommt, und es wird nichts gesendet.

Fordern Sie einen Schlüssel an und lesen Sie die vollständige Richtlinie zu Grenzen, Fehlercodes und Versionen unter https://www.reach120.com/developers.

Installation

Dieses Paket ist nicht auf npm veröffentlicht. Der Installationspfad ist dieses Repository, und es ist der einzige – @reach120/mcp-server wird im öffentlichen npm-Register nicht aufgelöst, und kein anderer Paketname steht dafür ein.

npx -y github:reach120/reach120-mcp

npm kompiliert das TypeScript während dieser Installation über das prepare-Skript, daher gibt es keinen separaten Build-Schritt.

Oder klonen Sie es und führen Sie es aus dem Quellcode aus:

git clone https://github.com/reach120/reach120-mcp.git
cd reach120-mcp
npm install
npm run build
node dist/index.js

Konfiguration

Claude Desktop (claude_desktop_config.json), Claude Code oder ein beliebiger MCP-Client, der stdio spricht:

{
  "mcpServers": {
    "reach120": {
      "command": "npx",
      "args": ["-y", "github:reach120/reach120-mcp"],
      "env": {
        "REACH120_API_KEY": "r120_live_your_key_here"
      }
    }
  }
}

Wie eine Ablehnung aussieht

Grenzen lehnen mit einem maschinenlesbaren Code ab, anstatt zu degradieren. Ein Aufruf, der das Tageskontingent des Schlüssels erreicht, wird nicht stillschweigend auf einer billigeren Engine bewertet und so zurückgegeben, als wäre es die Engine, die Sie angefordert haben – der Code benennt, was passiert ist, und die Fehlertabelle auf /developers erklärt, was jeder bedeutet.

Lokal verifizieren

npm install
npm run build
npm run verify

npm run verify startet den gebauten Server über stdio, führt einen echten MCP-Handshake mit dem SDK-Client durch, druckt die angekündigten Tools und ruft ein Tool ohne Schlüssel auf, um den Ablehnungspfad zu zeigen.

Bewertungen sind Übungsfeedback

score_writing_response gibt automatisiertes Übungsfeedback zurück, das von Reach120 erzeugt wird.

Es ist keine ETS-Bewertung und wird nicht auf der offiziellen Skala gemeldet. Diese README nennt bewusst nicht die Skala, auf der die Zahl ist: Diese Tatsache wird neben einer obligatorischen Einschränkung veröffentlicht, die das Anspruchsregister erfordert und die eine Paketseite nicht darstellen kann. Die Antwortstruktur ist unter https://www.reach120.com/developers dokumentiert.

TOEFL® ist ein eingetragenes Warenzeichen von ETS. Reach120 ist nicht mit ETS verbunden, von ETS unterstützt oder von ETS genehmigt.

Lizenz

MIT. Siehe LICENSE.