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: 1,036

Study sets

Records: 20

Annotated documents

Records: 2,240

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+20260715.
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. CC BY-NC 4.0.
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 · CC BY-NC 4.0

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 · Downloads

Downloads

07 · Collaborate

Collaborate

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