AILANG Docs is an MCP server published by io.github.sunholo-data, hosted at mcp.ailang.sunholo.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 22 tools, including ailang_versions, benchmarks_compare, benchmarks_for_model, benchmarks_list, changelog_for_version.
AILANG language reference, stdlib, examples and benchmarks for agents that write AILANG.
120 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List all AILANG versions the server can answer for.
No parameters.
{
"name": "ailang_versions",
"title": "AILANG versions",
"description": "List all AILANG versions the server can answer for.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"annotations": {
"title": "AILANG versions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| modelA * | string | |
| modelB * | string |
{
"name": "benchmarks_compare",
"title": "Compare two models on benchmarks",
"description": "Two models side by side across every banked run: passes, runs, pass rate,\ncost and failures by category. Model names are as benchmarks_list gives them.",
"inputSchema": {
"type": "object",
"required": [
"modelA",
"modelB"
],
"properties": {
"modelA": {
"type": "string"
},
"modelB": {
"type": "string"
}
}
},
"annotations": {
"title": "Compare two models on benchmarks",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Where does a given model pass/fail? Optional version filter. Output: {passes: [...], fails_by_category: {...}, total_cost}
| Parameter | Type | Description |
|---|---|---|
| model * | string | |
| version * | string |
{
"name": "benchmarks_for_model",
"title": "Benchmarks for a model",
"description": "Where does a given model pass/fail? Optional version filter.\nOutput: {passes: [...], fails_by_category: {...}, total_cost}",
"inputSchema": {
"type": "object",
"required": [
"model",
"version"
],
"properties": {
"model": {
"type": "string"
},
"version": {
"type": "string"
}
}
},
"annotations": {
"title": "Benchmarks for a model",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List benchmark suites and runs, optionally filtered to a since_version cutoff.
| Parameter | Type | Description |
|---|---|---|
| sinceVersion * | string |
{
"name": "benchmarks_list",
"title": "List benchmark runs",
"description": "List benchmark suites and runs, optionally filtered to a since_version cutoff.",
"inputSchema": {
"type": "object",
"required": [
"sinceVersion"
],
"properties": {
"sinceVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "List benchmark runs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}What changed in a given release (added/changed/fixed/breaking).
| Parameter | Type | Description |
|---|---|---|
| version * | string |
{
"name": "changelog_for_version",
"title": "Changelog for a version",
"description": "What changed in a given release (added/changed/fixed/breaking).",
"inputSchema": {
"type": "object",
"required": [
"version"
],
"properties": {
"version": {
"type": "string"
}
}
},
"annotations": {
"title": "Changelog for a version",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| slug * | string |
{
"name": "design_doc",
"title": "Read a design doc",
"description": "Full design doc by slug (e.g. \"m-agent-mcp-website\"), as markdown. Long\ndocuments are cut at 30,000 characters and say so; url opens the whole one.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
},
"annotations": {
"title": "Read a design doc",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List planned/implemented/rejected design docs, optionally filtered by version. state = "planned" | "implemented" | "rejected" | ""; empty = all.
| Parameter | Type | Description |
|---|---|---|
| state * | string | |
| version * | string |
{
"name": "design_docs_list",
"title": "List design docs",
"description": "List planned/implemented/rejected design docs, optionally filtered by version.\nstate = \"planned\" | \"implemented\" | \"rejected\" | \"\"; empty = all.",
"inputSchema": {
"type": "object",
"required": [
"state",
"version"
],
"properties": {
"state": {
"type": "string"
},
"version": {
"type": "string"
}
}
},
"annotations": {
"title": "List design docs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The AILANG docs site's navigation tree for a version, as JSON: section and page titles with their paths.
| Parameter | Type | Description |
|---|---|---|
| forVersion * | string |
{
"name": "docs_nav",
"title": "Docs navigation",
"description": "The AILANG docs site's navigation tree for a version, as JSON: section and\npage titles with their paths.",
"inputSchema": {
"type": "object",
"required": [
"forVersion"
],
"properties": {
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Docs navigation",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| query * | string | |
| forVersion * | string |
{
"name": "docs_search",
"title": "Search AILANG docs",
"description": "Full-text search of the AILANG documentation for a version (case-insensitive,\non page titles and text). Returns the top 10 matches, docs pages before\narchived teaching prompts, each with its path, title, first 10 headings and\nan excerpt around the match.",
"inputSchema": {
"type": "object",
"required": [
"query",
"forVersion"
],
"properties": {
"query": {
"type": "string"
},
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Search AILANG docs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}All declared effects with capability mapping and the version they appeared in.
| Parameter | Type | Description |
|---|---|---|
| forVersion * | string |
{
"name": "effects_catalog",
"title": "Effects catalog",
"description": "All declared effects with capability mapping and the version they appeared in.",
"inputSchema": {
"type": "object",
"required": [
"forVersion"
],
"properties": {
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Effects catalog",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| concept * | string | |
| forVersion * | string |
{
"name": "example_for_concept",
"title": "Example for a concept",
"description": "Best-fit examples for a free-form concept query (\"how do I use effects?\").\nFilters server-side on why + title; returns up to 5 matches.",
"inputSchema": {
"type": "object",
"required": [
"concept",
"forVersion"
],
"properties": {
"concept": {
"type": "string"
},
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Example for a concept",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| forVersion * | string |
{
"name": "example_get",
"title": "Get an example",
"description": "Full source of one example by path (as examples_list gives it, e.g.\n\"runnable/hello.ail\"; a leading \"examples/\" is accepted), at the release.",
"inputSchema": {
"type": "object",
"required": [
"path",
"forVersion"
],
"properties": {
"path": {
"type": "string"
},
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Get an example",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| status * | string | |
| features * | string | |
| forVersion * | string |
{
"name": "examples_list",
"title": "List examples",
"description": "Examples in the release's manifest (examples/manifest.json at its tag).\nfeatures = comma-separated tags (\"effects,records\"); empty = no filter.\nstatus = \"working\" | \"broken\" | \"aspirational\" | \"\" (\"passing\" = working,\n\"failing\" = the other two); empty = working only. At most 50 are returned;\ntotal says how many matched.",
"inputSchema": {
"type": "object",
"required": [
"features",
"status",
"forVersion"
],
"properties": {
"status": {
"type": "string"
},
"features": {
"type": "string"
},
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "List examples",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| harness * | string | |
| platform * | string |
{
"name": "install_guide",
"title": "AILANG install guide",
"description": "Harness-aware install instructions for AILANG.\nharness: \"claude-code\" | \"gemini-cli\" | \"codex-cli\" | \"manual\" | \"build-from-source\" | \"\"\nplatform: only meaningful for \"manual\" (e.g. \"darwin-arm64\", \"linux-amd64\"); ignored otherwise\nEmpty harness returns ALL harnesses + the remote_mcp config block.",
"inputSchema": {
"type": "object",
"required": [
"harness",
"platform"
],
"properties": {
"harness": {
"type": "string"
},
"platform": {
"type": "string"
}
}
},
"annotations": {
"title": "AILANG install guide",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Known limitations (Y-combinator, etc.) optionally filtered by category.
| Parameter | Type | Description |
|---|---|---|
| category * | string | |
| forVersion * | string |
{
"name": "limitations_list",
"title": "Known limitations",
"description": "Known limitations (Y-combinator, etc.) optionally filtered by category.",
"inputSchema": {
"type": "object",
"required": [
"category",
"forVersion"
],
"properties": {
"category": {
"type": "string"
},
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Known limitations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| role * | string |
{
"name": "onboarding_guide",
"title": "AILANG onboarding guide",
"description": "Step-by-step guide to getting started with AILANG, for an AI coding agent\nand for a human developer. role: \"agent\" | \"developer\" | \"\" (both). The\nguide for both roles is returned whatever role says; pick the part you need.",
"inputSchema": {
"type": "object",
"required": [
"role"
],
"properties": {
"role": {
"type": "string"
}
}
},
"annotations": {
"title": "AILANG onboarding guide",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch the canonical teaching prompt for a version. kind = "" (the full prompt) | "agent" | "devtools".
| Parameter | Type | Description |
|---|---|---|
| kind * | string | |
| forVersion * | string |
{
"name": "prompt_get",
"title": "Get an AILANG teaching prompt",
"description": "Fetch the canonical teaching prompt for a version.\nkind = \"\" (the full prompt) | \"agent\" | \"devtools\".",
"inputSchema": {
"type": "object",
"required": [
"forVersion",
"kind"
],
"properties": {
"kind": {
"type": "string"
},
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Get an AILANG teaching prompt",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "roadmap",
"title": "AILANG roadmap",
"description": "What's shipping next, what's been rejected and why: the roadmap page of the\nAILANG site, generated from the planned design docs, as markdown.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"annotations": {
"title": "AILANG roadmap",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Full module: exports + signatures + docstrings.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| forVersion * | string |
{
"name": "stdlib_module",
"title": "Stdlib module reference",
"description": "Full module: exports + signatures + docstrings.",
"inputSchema": {
"type": "object",
"required": [
"name",
"forVersion"
],
"properties": {
"name": {
"type": "string"
},
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Stdlib module reference",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List stdlib modules available in this AILANG version with one-line summaries.
| Parameter | Type | Description |
|---|---|---|
| forVersion * | string |
{
"name": "stdlib_modules",
"title": "List stdlib modules",
"description": "List stdlib modules available in this AILANG version with one-line summaries.",
"inputSchema": {
"type": "object",
"required": [
"forVersion"
],
"properties": {
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "List stdlib modules",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Find stdlib functions by name, signature, or keyword. Filters the pre-built search index server-side; returns top 20 matches.
| Parameter | Type | Description |
|---|---|---|
| query * | string | |
| forVersion * | string |
{
"name": "stdlib_search",
"title": "Search the stdlib",
"description": "Find stdlib functions by name, signature, or keyword.\nFilters the pre-built search index server-side; returns top 20 matches.",
"inputSchema": {
"type": "object",
"required": [
"query",
"forVersion"
],
"properties": {
"query": {
"type": "string"
},
"forVersion": {
"type": "string"
}
}
},
"annotations": {
"title": "Search the stdlib",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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 instead. Returns a ticket ID.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Full description (≤10 KB) |
| title * | string | Short title for the report |
| contact | string | Optional address for a reply. Only if the user gives one |
| package | string | Optional vendor/name (e.g. "sunholo/auth") to send the report to that package's maintainers. Empty = the AILANG team. |
| snippet | string | Optional code/error snippet (≤4 KB) |
| category * | string | bug | feature | docs | limitation |
| auto_dispatch | boolean | Let the package maintainers' automation act on the report before a person reads it. Only if the user asks. Default false: a person triages it first. |
| ailang_version * | string | The reporter's CLI version (free-form, used for triage) |
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "submit_feedback",
"title": "Send feedback",
"description": "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 instead. Returns a ticket ID.",
"inputSchema": {
"type": "object",
"required": [
"title",
"body",
"category",
"ailang_version"
],
"properties": {
"body": {
"type": "string",
"description": "Full description (≤10 KB)"
},
"title": {
"type": "string",
"description": "Short title for the report"
},
"contact": {
"type": "string",
"description": "Optional address for a reply. Only if the user gives one"
},
"package": {
"type": "string",
"description": "Optional vendor/name (e.g. \"sunholo/auth\") to send the report to that package's maintainers. Empty = the AILANG team."
},
"snippet": {
"type": "string",
"description": "Optional code/error snippet (≤4 KB)"
},
"category": {
"type": "string",
"description": "bug | feature | docs | limitation"
},
"auto_dispatch": {
"type": "boolean",
"description": "Let the package maintainers' automation act on the report before a person reads it. Only if the user asks. Default false: a person triages it first."
},
"ailang_version": {
"type": "string",
"description": "The reporter's CLI version (free-form, used for triage)"
}
}
},
"annotations": {
"title": "Send feedback",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}