# AILANG Docs

> AILANG Docs is an open-source MCP server for developer tools. Search AILANG's language reference, stdlib, examples and benchmarks from an agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI
- **Website:** https://ailang.sunholo.com
- **Repository:** https://github.com/sunholo-data/ailang
- **MCP Registry name:** io.github.sunholo-data/ailang-docs
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

AILANG is a purely functional language with explicit effects, built so AI-generated programs are easier to check, replay and debug. This server is its documentation side, hosted at mcp.ailang.sunholo.com and open for agents that write AILANG.

The site's pitch: an agent writes .ail files, AILANG checks types, effects, capabilities and inline contracts, then runs deterministically with capabilities such as --caps IO,FS. Structured per-effect traces feed errors back to the agent. A hello-world example prints with the IO effect.

The README lists MCP tools including `ailang_prompt`, `ailang_check`, `ailang_run`, `ailang_builtins` and `ailang_eval` through the bootstrap plugin, which needs the local ailang CLI. The docs server itself is the part that needs no install.

## Features

- **Typed doc tools:** Standard library, examples, design docs and benchmarks.
- **Effect-typed language:** Side effects are explicit in types.
- **Deterministic runs:** Same input gives same output.
- **Capability limits:** Run programs under --caps.
- **Structured traces:** Errors are sliced by effect type.
- **Plugins:** Claude Code and Codex bootstrap.

## Good for

- Teach an agent AILANG syntax before it writes code
- Look up a stdlib module while coding
- Find an example for a concept
- Compare benchmark results across models

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ailang-docs https://mcp.ailang.sunholo.com/mcp/
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.ailang.sunholo.com/mcp/
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ailang-docs": {
      "url": "https://mcp.ailang.sunholo.com/mcp/"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ailang-docs": {
      "type": "http",
      "url": "https://mcp.ailang.sunholo.com/mcp/"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ailang-docs": {
      "serverUrl": "https://mcp.ailang.sunholo.com/mcp/"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ailang-docs": {
      "type": "http",
      "url": "https://mcp.ailang.sunholo.com/mcp/"
    }
  }
}
```

## Tools

- `ailang_versions`: List all AILANG versions the server can answer for.
- `benchmarks_compare`: Two models side by side across every banked run: passes, runs, pass rate, cost and failures by category. Model names are as benchmarks_list gives them.
- `benchmarks_for_model`: Where does a given model pass/fail? Optional version filter. Output: {passes: [...], fails_by_category: {...}, total_cost}
- `benchmarks_list`: List benchmark suites and runs, optionally filtered to a since_version cutoff.
- `changelog_for_version`: What changed in a given release (added/changed/fixed/breaking).
- `design_doc`: Full design doc by slug (e.g. "m-agent-mcp-website"), as markdown. Long documents are cut at 30,000 characters and say so; url opens the whole one.
- `design_docs_list`: List planned/implemented/rejected design docs, optionally filtered by version. state = "planned" | "implemented" | "rejected" | ""; empty = all.
- `docs_nav`: The AILANG docs site's navigation tree for a version, as JSON: section and page titles with their paths.
- `docs_search`: Full-text search of the AILANG documentation for a version (case-insensitive, on page titles and text). Returns the top 10 matches, docs pages before archived teaching prompts, each with its path, title, first 10 headings and an excerpt around the match.
- `effects_catalog`: All declared effects with capability mapping and the version they appeared in.
- `example_for_concept`: Best-fit examples for a free-form concept query ("how do I use effects?"). Filters server-side on why + title; returns up to 5 matches.
- `example_get`: Full source of one example by path (as examples_list gives it, e.g. "runnable/hello.ail"; a leading "examples/" is accepted), at the release.
- `examples_list`: Examples in the release's manifest (examples/manifest.json at its tag). features = comma-separated tags ("effects,records"); empty = no filter. status = "working" | "broken" | "aspirational" | "" ("passing" = working, "failing" = the other two); empty = working only. At most 50 are returned; total says how many matched.
- `install_guide`: Harness-aware install instructions for AILANG. harness: "claude-code" | "gemini-cli" | "codex-cli" | "manual" | "build-from-source" | "" platform: only meaningful for "manual" (e.g. "darwin-arm64", "linux-amd64"); ignored otherwise Empty harness returns ALL harnesses + the remote_mcp config block.
- `limitations_list`: Known limitations (Y-combinator, etc.) optionally filtered by category.
- `onboarding_guide`: Step-by-step guide to getting started with AILANG, for an AI coding agent and for a human developer. role: "agent" | "developer" | "" (both). The guide for both roles is returned whatever role says; pick the part you need.
- `prompt_get`: Fetch the canonical teaching prompt for a version. kind = "" (the full prompt) | "agent" | "devtools".
- `roadmap`: What's shipping next, what's been rejected and why: the roadmap page of the AILANG site, generated from the planned design docs, as markdown.
- `stdlib_module`: Full module: exports + signatures + docstrings.
- `stdlib_modules`: List stdlib modules available in this AILANG version with one-line summaries.
- `stdlib_search`: Find stdlib functions by name, signature, or keyword. Filters the pre-built search index server-side; returns top 20 matches.
- `submit_feedback`: Send a bug report, feature request, documentation gap or limitation about AILANG to the AILANG team. Use it only when the user asks to report something, and leave out personal or confidential information. Categories: bug, feature, docs, limitation. Body up to 10 KB, snippet up to 4 KB. `contact` is optional, for a reply. `package` (vendor/name) sends the report to that AILANG package's maintainers

## FAQ

### Does it need sign-in?

The docs server at mcp.ailang.sunholo.com needs no sign-in.

### Does it run code?

Local plugin tools call the ailang CLI; this docs server serves reference material.

### Which agents are supported?

Claude Code and OpenAI Codex plugins are described.

### How do I install the CLI?

With the curl install script on ailang.sunholo.com.

### Is AILANG Docs free?

Yes. AILANG Docs is open source, so you can use and self-host it for free.

### How do I add AILANG Docs to Claude Code?

Run this command in your terminal: claude mcp add --transport http ailang-docs https://mcp.ailang.sunholo.com/mcp/

### What are the best alternatives to AILANG Docs?

The closest alternatives to AILANG Docs are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ailang-docs
