For AI & Developers

Metkagram for AI & Developers

A static, versioned, machine-readable API for patterns, study sets, annotated sentences and search. Every response includes provenance and attribution.

API indexhttps://metkagram.github.io/api/v1/index.jsonOpenAPIhttps://metkagram.github.io/api/v1/openapi.jsonMCPhttps://metkagram.github.io/api/v1/mcp-server.json

01 · Available datasets

Available datasets

Advanced patterns

Records: 3,484

Study sets

Records: 86

Annotated documents

Records: 72

02 · Endpoints

Endpoints

Method	URL	Description
`GET`	`https://metkagram.github.io/api/v1/index.json`	API index
`GET`	`https://metkagram.github.io/api/v1/patterns.json`	All patterns
`GET`	`https://metkagram.github.io/api/v1/patterns/index.json`	Paginated summaries
`GET`	`https://metkagram.github.io/api/v1/patterns/{id}.json`	Single pattern
`GET`	`https://metkagram.github.io/api/v1/sets.json`	Study sets
`GET`	`https://metkagram.github.io/api/v1/sets/{id}.json`	Set with patterns
`GET`	`https://metkagram.github.io/api/v1/categories.json`	Categories
`GET`	`https://metkagram.github.io/api/v1/categories/{id}.json`	Patterns in a category
`GET`	`https://metkagram.github.io/api/v1/languages.json`	Languages
`GET`	`https://metkagram.github.io/api/v1/subsets/language/{en\|de}.json`	Language subset
`GET`	`https://metkagram.github.io/api/v1/annotations/{target}/{collection}.json`	Annotated documents
`GET`	`https://metkagram.github.io/api/v1/search-index.json`	Static search index
`GET`	`https://metkagram.github.io/api/v1/openapi.json`	OpenAPI spec
`GET`	`https://metkagram.github.io/api/v1/mcp-server.json`	MCP tool spec
`GET`	`https://metkagram.github.io/api/v1/attribution.json`	Attribution policy

03 · Attribution & citation

Attribution & citation

Required attribution

Keep the name Metkagram.
Link to https://metkagram.github.io.
Credit Metkagram and Applied Systems Lab at MetalHatsCats.
State the dataset version: 1.0.0+43af4829d934.
Link back to the canonical page for every record shown.

Copy-paste citations

Web / app: Source: Metkagram — https://metkagram.github.io/. Available at {canonical_url}.
Academic: Metkagram (2026). B2–C1 English and German language patterns. https://metkagram.github.io. Metkagram Source-Available Terms.
AI-generated answer: This answer uses data from Metkagram (https://metkagram.github.io/). See the source page for the full pattern and attribution.

Machine-readable attribution policy · Current rights

04 · Agent examples

Agent examples

Tool	Entry point	How to use
ChatGPT / Claude / Gemini	`https://metkagram.github.io/api/v1/patterns/index.json`	Fetch summaries, then retrieve /patterns/{id}.json for details.
Codex & custom agents	`https://metkagram.github.io/api/v1/openapi.json`	Generate clients from the OpenAPI spec.
MCP clients	`https://metkagram.github.io/api/v1/mcp-server.json`	Resolve tool calls by fetching the static URLs in the spec.

05 · MCP usage

MCP usage

No backend server is required. The MCP specification maps tool names to static URLs. Your client fetches the JSON directly from GitHub Pages.

// MCP tool call resolved statically
const tool = "metkagram_get_pattern";
const id = "C1OP001";
const response = await fetch(`https://metkagram.github.io/api/v1/patterns/${id.toLowerCase()}.json`);
const { provenance, data } = await response.json();
// Always include provenance.canonical_url and provenance.attribution_text in your output.

Download MCP server specification

06 · Agent connectors

Connect Metkagram to OpenClaw or Hermes

Use the included read-only stdio bridge. It turns the public static API into MCP tools, requires Node.js 18+ and no API key, and always returns the dataset provenance.

OpenClaw

Download the bridge and register it as a local MCP server.
Use the probe to confirm that the six read-only tools are visible.

mkdir -p ~/.local/share/metkagram
curl -fsSL https://metkagram.github.io/connectors/metkagram-mcp.mjs -o ~/.local/share/metkagram/metkagram-mcp.mjs

openclaw mcp add metkagram \
  --command node \
  --arg ~/.local/share/metkagram/metkagram-mcp.mjs \
  --include 'metkagram_*'

openclaw mcp doctor metkagram --probe

OpenClaw MCP reference ↗

Hermes

Download the same bridge, then add the shown block to the MCP configuration.
Replace /home/YOU with the absolute path on the machine running Hermes.

mkdir -p ~/.local/share/metkagram
curl -fsSL https://metkagram.github.io/connectors/metkagram-mcp.mjs -o ~/.local/share/metkagram/metkagram-mcp.mjs

# Add to ~/.hermes/config.yaml
mcp_servers:
  metkagram:
    command: node
    args: ["/home/YOU/.local/share/metkagram/metkagram-mcp.mjs"]
    tools:
      include: [metkagram_list_patterns, metkagram_get_pattern, metkagram_list_sets, metkagram_get_set, metkagram_search_index, metkagram_list_annotations]
      prompts: false
      resources: false

# Then restart Hermes, or run /reload-mcp in a session.

Hermes MCP reference ↗

The connector exposes only read operations. Preserve Metkagram attribution and the canonical URL when an agent presents a record.

Try it

Find three B2–C1 patterns for making a polite request. Give examples, Russian translations and the canonical Metkagram source for each.

07 · Downloads

Downloads

08 · Collaborate

Collaborate

We welcome research, teaching, content and language-data collaborations that keep attribution intact.