AILANG Docs
AILANG language reference, stdlib, examples and benchmarks for agents that write AILANG.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (2)
- LOWen docs_nav
- LOWen effects_catalog
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"ailang-docs": {
"url": "https://mcp.ailang.sunholo.com/mcp/"
}
}
}Puntos de conexión remotos
https://mcp.ailang.sunholo.com/mcp/streamable-httpQué puede hacer
Inventario de herramientas
Herramientas (22)
🟢ailang_versions
List all AILANG versions the server can answer for.
Esquema de entrada
{
"type": "object",
"properties": {},
"required": []
}🟢benchmarks_compare(modelA, modelB)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"modelA": {
"type": "string"
},
"modelB": {
"type": "string"
}
},
"required": [
"modelA",
"modelB"
]
}🟢benchmarks_for_model(model, version)
Where does a given model pass/fail? Optional version filter. Output: {passes: [...], fails_by_category: {...}, total_cost}
Esquema de entrada
{
"type": "object",
"properties": {
"model": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"model",
"version"
]
}🟢benchmarks_list(sinceVersion)
List benchmark suites and runs, optionally filtered to a since_version cutoff.
Esquema de entrada
{
"type": "object",
"properties": {
"sinceVersion": {
"type": "string"
}
},
"required": [
"sinceVersion"
]
}🟢changelog_for_version(version)
What changed in a given release (added/changed/fixed/breaking).
Esquema de entrada
{
"type": "object",
"properties": {
"version": {
"type": "string"
}
},
"required": [
"version"
]
}🟢design_doc(slug)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string"
}
},
"required": [
"slug"
]
}🟢design_docs_list(state, version)
List planned/implemented/rejected design docs, optionally filtered by version. state = "planned" | "implemented" | "rejected" | ""; empty = all.
Esquema de entrada
{
"type": "object",
"properties": {
"state": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"state",
"version"
]
}🟢docs_nav(forVersion)
The AILANG docs site's navigation tree for a version, as JSON: section and page titles with their paths.
Esquema de entrada
{
"type": "object",
"properties": {
"forVersion": {
"type": "string"
}
},
"required": [
"forVersion"
]
}🟢docs_search(forVersion, query)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"forVersion": {
"type": "string"
},
"query": {
"type": "string"
}
},
"required": [
"query",
"forVersion"
]
}🟢effects_catalog(forVersion)
All declared effects with capability mapping and the version they appeared in.
Esquema de entrada
{
"type": "object",
"properties": {
"forVersion": {
"type": "string"
}
},
"required": [
"forVersion"
]
}🟢example_for_concept(concept, forVersion)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"concept": {
"type": "string"
},
"forVersion": {
"type": "string"
}
},
"required": [
"concept",
"forVersion"
]
}🟢example_get(forVersion, path)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"forVersion": {
"type": "string"
},
"path": {
"type": "string"
}
},
"required": [
"path",
"forVersion"
]
}🟢examples_list(features, forVersion, status)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"features": {
"type": "string"
},
"forVersion": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"features",
"status",
"forVersion"
]
}🟢install_guide(harness, platform)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"harness": {
"type": "string"
},
"platform": {
"type": "string"
}
},
"required": [
"harness",
"platform"
]
}🟢limitations_list(category, forVersion)
Known limitations (Y-combinator, etc.) optionally filtered by category.
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"type": "string"
},
"forVersion": {
"type": "string"
}
},
"required": [
"category",
"forVersion"
]
}🟢onboarding_guide(role)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"role": {
"type": "string"
}
},
"required": [
"role"
]
}🟢prompt_get(forVersion, kind)
Fetch the canonical teaching prompt for a version. kind = "" (the full prompt) | "agent" | "devtools".
Esquema de entrada
{
"type": "object",
"properties": {
"forVersion": {
"type": "string"
},
"kind": {
"type": "string"
}
},
"required": [
"forVersion",
"kind"
]
}🟢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.
Esquema de entrada
{
"type": "object",
"properties": {},
"required": []
}🟢stdlib_module(forVersion, name)
Full module: exports + signatures + docstrings.
Esquema de entrada
{
"type": "object",
"properties": {
"forVersion": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"name",
"forVersion"
]
}🟢stdlib_modules(forVersion)
List stdlib modules available in this AILANG version with one-line summaries.
Esquema de entrada
{
"type": "object",
"properties": {
"forVersion": {
"type": "string"
}
},
"required": [
"forVersion"
]
}🟢stdlib_search(forVersion, query)
Find stdlib functions by name, signature, or keyword. Filters the pre-built search index server-side; returns top 20 matches.
Esquema de entrada
{
"type": "object",
"properties": {
"forVersion": {
"type": "string"
},
"query": {
"type": "string"
}
},
"required": [
"query",
"forVersion"
]
}🟡submit_feedback(ailang_version, auto_dispatch, body, category, contact, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"ailang_version": {
"type": "string",
"description": "The reporter's CLI version (free-form, used for triage)"
},
"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."
},
"body": {
"type": "string",
"description": "Full description (≤10 KB)"
},
"category": {
"type": "string",
"description": "bug | feature | docs | limitation"
},
"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)"
},
"title": {
"type": "string",
"description": "Short title for the report"
}
},
"required": [
"title",
"body",
"category",
"ailang_version"
]
}Comunidad
Evidencia