MCP · AI tutor

Use Metkagram with an AI tutor

MCP gives an AI access to Metkagram's published patterns, stable IDs, study sets and relationships. The model can explain and select learning material without inventing a new curriculum on every turn.

Download MCP bridge

01 · For learners

What this gives a language learner

Use AI as an interface to inspectable Metkagram learning objects: find the structure first, then retrieve and reuse it yourself.

01Find a structure by intentStart from a goal such as disagreeing politely, correcting an assumption, comparing alternatives or drawing a conclusion.

02Inspect your own sentenceAsk for the closest published pattern and require the assistant to keep the canonical pattern ID in its answer.

03Practise retrievalAsk the tutor to give you a situation first and hide the formula until you attempt the structure.

04Compare nearby patternsAsk what two related structures do differently and when each one is a better fit.

02 · Practice

Prompts you can use

Find a B2–C1 Metkagram pattern for disagreeing politely. Cite the pattern ID, explain the English and German frames, then ask me to make my own example before giving feedback.

I wrote: ‘It is not the price; it is the timing.’ Find the closest Metkagram pattern. Show the stable pattern ID and explain what reasoning move it performs.

Choose one Metkagram pattern I can use to compare two alternatives. Give me a situation first. Do not show the answer until I try.

Compare two related Metkagram patterns for correcting an assumption. Tell me when each one sounds more natural and keep the canonical IDs in the answer.

03 · MCP

Connect it

Metkagram publishes a small read-only stdio bridge. Save the file locally and point an MCP client at it. It needs Node.js 18+; no Metkagram account or API key is required.

Typical MCP client configuration

{
  "mcpServers": {
    "metkagram": {
      "command": "node",
      "args": ["/absolute/path/metkagram-mcp.mjs"]
    }
  }
}

The exact configuration field depends on the client. The important part is simply that the client launches Node.js with the path to the local bridge file.

04 · Tools

What the AI receives through MCP

01DiscoverChoose the right Metkagram surface for a task: Lens, intent search, Practice, Graph or API.

02PatternsRetrieve published patterns and stable IDs instead of freely generating a learning corpus.

03Study setsWork with themed B2–C1 sets and learning sequences.

04IntentsMove from a communicative goal to a reasoning move and suitable structures.

05AnnotationsOpen selected annotated sentences for context and structural inspection.

05 · Boundaries

What it is not

This is a read-only bridge to public static data, not a hosted remote MCP endpoint. It does not store learner progress, change project data or claim to be a complete grammar grader. Practice and review state remain local in the browser.

06 · Machine-readable

For clients and agents

Machine-readable entry points let clients use canonical records rather than scrape HTML, while preserving provenance and attribution.

JSONMCP tool manifesthttps://metkagram.github.io/api/v1/mcp-server.json JSONCapability / recommendation indexhttps://metkagram.github.io/api/v1/discovery.json APIPublic API indexhttps://metkagram.github.io/api/v1/index.json DOCAI & developer documentation/en/ai/