# ablaut-mcp

An [MCP](https://modelcontextprotocol.io) server that lets AI agents
conjugate verbs in 20+ languages. Each tool call is one request
to the hosted [ablaut](https://github.com/ablaut-dev/ablaut) API, where
the engine runs as native Rust: no local build, sub-millisecond compute.
Set `ABLAUT_API_URL` to point at another instance.

The API is in early access and requires a key, passed via the
`ABLAUT_API_KEY` environment variable. Request one at
[ablaut.dev](https://www.ablaut.dev) (the API dialog).

Try the engine in the browser at [ablaut.dev](https://www.ablaut.dev);
full API and response-shape reference at
[ablaut.dev/api](https://www.ablaut.dev/api).

## Setup

Claude Code:

```sh
claude mcp add ablaut -- npx -y @v4nn4/ablaut-mcp
```

Claude Desktop, Cursor, or any other MCP client:

```json
{
  "mcpServers": {
    "ablaut": {
      "command": "npx",
      "args": ["-y", "@v4nn4/ablaut-mcp"]
    }
  }
}
```

## Tools

- **conjugate** `(verb, language)`: the full conjugation table for an
  infinitive, covering every simple and composed tense of the
  language's written standard. Language codes are ISO 639-1 (`fr`),
  ISO 639-3 (`fra`), or English names (`French`), case-insensitive.
- **find_infinitive** `(form, language)`: reverse lookup — the
  infinitive(s) a conjugated form belongs to, with the slots it
  occupies (`suis` matches both *être* and *suivre*).
- **list_languages**: supported languages and their maturity status.

## Languages

German, French, Spanish, Portuguese, Italian, Romanian, Swedish,
English, Danish, Czech, Slovenian, Estonian, Finnish, and Irish.
Every language is validated against two independent gold lexicons;
see the [ablaut repository](https://github.com/ablaut-dev/ablaut) for
per-language accuracy and adjudication logs.

## Hosted API

We are building a hosted conjugation API (REST and remote MCP):
sub-millisecond responses, one endpoint for all languages.
Interested? Tell us at [ablaut.dev](https://www.ablaut.dev).

## License

MIT OR Apache-2.0.