AILANG Docs MCP server
Commit Nov 13, 2026Provides language reference, standard library, examples, and benchmarks for AI agents writing AILANG code.
Also known as sunholo-data/ailang, ailang
- Stars
- 38
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.60.5
- Last commit
- Nov 13, 2026
- License
- Apache-2.0
What is AILANG Docs MCP?
AILANG Docs provides language reference, standard library, examples, and benchmarks for AI agents writing AILANG code.
Summary generated from the project's README
About AILANG Docs MCP server
Providing language reference, standard library details, and benchmarks for AI agents writing AILANG code is what this server enables. It is designed specifically for machine reasoning and deterministic execution, offering a functional language substrate that agents can use to generate verifiable code. The system works by integrating with local environments through the AILANG CLI, which must be installed on the user's PATH.
Developers using Claude Code or OpenAI Codex can install the AILANG Bootstrap to gain access to specialized MCP tools and agent skills. These tools include ailang_prompt, ailang_check, ailang_run, ailang_builtins, and ailang_eval. The integration provides persistent guidance through files like CLAUDE.md or AGENTS.md, ensuring agents follow current syntax rules and idioms. This setup allows AI clients to perform authoring, debugging, and design-doc workflows using a purely functional language with Hindley-Milner type inference and capability-based security.
What you can do with it
- 1Authoring deterministic AILANG codeAn AI agent can write functional code using the provided syntax rules and idioms.
- 2Verifying and running code snippetsA developer can task an agent with checking or executing AILANG programs via local tools.
- 3Debugging and workflow managementAgents can utilize specialized skills to handle debugging and sprint workflows.
- 4Integrating with AI coding environmentsUsers can add AILANG capabilities directly to Claude Code or OpenAI Codex.
Written from the project's README. Every use case is checked against a quote from it.
How to install AILANG Docs MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AILANG Docs MCP in Claude Code
$ claude mcp add --transport http ailang https://mcp.ailang.sunholo.com/mcp/Install AILANG Docs MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ailang": {
"url": "https://mcp.ailang.sunholo.com/mcp/"
}
}
}Install AILANG Docs MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ailang": {
"type": "http",
"url": "https://mcp.ailang.sunholo.com/mcp/"
}
}
}Install AILANG Docs MCP in VS Code CLI
$ code --add-mcp '{"name":"ailang","type":"http","url":"https://mcp.ailang.sunholo.com/mcp/"}'Install AILANG Docs MCP in Codex
$ codex mcp add ailang --url https://mcp.ailang.sunholo.com/mcp/Install AILANG Docs MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ailang] url = "https://mcp.ailang.sunholo.com/mcp/"
Install AILANG Docs MCP in Gemini CLI
$ gemini mcp add -s user --transport http ailang https://mcp.ailang.sunholo.com/mcp/Install AILANG Docs MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ailang": {
"url": "https://mcp.ailang.sunholo.com/mcp/",
"type": "http"
}
}
}Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesunholo-data/ailang is public and reachablegithub.com/sunholo-data/ailang ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/sunholo-data/ailang ↗Pass
- OpenSSF ScorecardOpenSSF Scorecard 6.7 / 10; weakest: Code-Review 0, Token-Permissions 0, Vulnerabilities 0scorecard.dev/viewer/?uri=github.com/sunholo-data/ailang ↗Partial 10/15
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 81 msPass
README
View on GitHubAILANG: The Deterministic Language for AI Coders
Third-party verification. AILANG is written autonomously by AI agents via its own coordinator. The badges above are independent static-analysis and supply-chain scores — not self-reported. The benchmark dashboard publishes the live correctness signal across current benchmark and model cohorts.
AILANG is a purely functional, effect-typed language designed as a deterministic execution substrate for AI-generated code. Every construct has deterministic semantics that can be reflected, verified, and serialized.
Documentation | Examples | Live Demos | Vision | Benchmarks
Quick Start
AILANG is designed to be used by AI coding agents. The AILANG Bootstrap packages the current language guidance, reusable skills, and local MCP tools for Claude Code and OpenAI Codex.
Install the AILANG CLI first:
curl -fsSL https://ailang.sunholo.com/install.sh | bash
ailang --version
The agent integrations call the local ailang executable, so it must be
available on PATH.
With Claude Code
/plugin marketplace add sunholo-data/ailang_bootstrap
/plugin install ailang@sunholo-data/ailang_bootstrap
With OpenAI Codex
AILANG Bootstrap also ships a Codex plugin manifest. Add its stable marketplace:
# Required by the plugin's local MCP server on first launch
node --version
npm --version
codex plugin marketplace add sunholo-data/ailang_bootstrap --ref stable
codex plugin add ailang@ailang-marketplace
codex plugin list
Start a new Codex session after installation. Alternatively, after adding the
marketplace, launch codex, enter /plugins, and install ailang from the
AILANG marketplace. The plugin can also be installed from the Plugins directory
in the Codex desktop app. Codex plugins are not currently available in the IDE
extension.
Codex reads this repository's AGENTS.md automatically, whether or
not the plugin is installed. The plugin adds the reusable AILANG skills and MCP
tools; AGENTS.md supplies repository-specific workflows and guardrails.
What the Agent Package Provides
- CLI integration - Skills and tools use the separately installed
ailangexecutable - MCP tools -
ailang_prompt,ailang_check,ailang_run,ailang_builtins,ailang_eval - Agent skills - AILANG authoring, debugging, messaging, design-doc, and sprint workflows
- Teaching guidance - Current syntax rules via repository guidance, skills, and
ailang prompt
The packaging is intentionally native to each host:
| Capability | Claude Code | Codex |
|---|---|---|
| Persistent guidance | CLAUDE.md |
AGENTS.md |
| Reusable workflows | Plugin skills | Plugin skills |
| Local AILANG MCP tools | Yes | Yes |
| Host-native commands | Claude slash commands | Skills and MCP tools |
| AILANG Bootstrap hooks | Claude hooks | Not currently packaged |
Once installed, ask the agent to write AILANG code. All agents should run
ailang prompt before authoring .ail files; it is the installed CLI's source
for current syntax and idioms.
See ailang_bootstrap for details.
The installer detects your OS and architecture automatically. To pin a release:
curl -fsSL https://ailang.sunholo.com/install.sh | VERSION=v0.33.1 bash
# macOS (Apple Silicon)
curl -L https://github.com/sunholo-data/ailang/releases/latest/download/darwin.arm64.ailang.tar.gz | tar -xz
sudo mv ailang /usr/local/bin/
# macOS (Intel)
curl -L https://github.com/sunholo-data/ailang/releases/latest/download/darwin.x64.ailang.tar.gz | tar -xz
sudo mv ailang /usr/local/bin/
# Linux
curl -L https://github.com/sunholo-data/ailang/releases/latest/download/linux.x64.ailang.tar.gz | tar -xz
sudo mv ailang /usr/local/bin/
# From source
git clone https://github.com/sunholo-data/ailang.git
cd ailang && make install
# Verify
ailang --version
For complete setup instructions, see the Getting Started Guide.
Hello World
module examples/hello_world
import std/io (println)
export func main() -> () ! {IO} {
println("Hello, World!")
}
ailang run --caps IO examples/hello_world.ail
# Output: Hello, World!
Interactive REPL
ailang repl
λ> 1 + 2
3 :: Int
λ> let double = \x. x * 2 in double(21)
42 :: Int
λ> :type \x. x + x
\x. x + x :: ∀α. Num α ⇒ α → α
λ> :quit
Key Features
- Pure functional - Lambda calculus, closures, pattern matching, ADTs
- Type inference - Hindley-Milner with row polymorphism
- Effect system - Capability-based security (IO, FS, Net, Clock, AI)
- Deterministic - Replayable execution, structured traces
- AI-first - Designed for machine reasoning, not human convenience
- LSP -
ailang lsp --stdioships in the binary: diagnostics, hover types, go-to-def, references, document symbols. One-command VS Code install:ailang editor install vscode(guide)
Learn more: Why AILANG? | No Loops Design | Go Interop | Stability Promise (1.x)
Development
make install # Build and install
make test # Run all tests
make repl # Start REPL
make lint # Run linter
Guides:
- Development Guide
- CONTRIBUTING.md
- AGENTS.md - Cross-agent repository instructions (including Codex)
- CLAUDE.md - Detailed AILANG operational workflows
Project Structure
ailang/
├── cmd/ailang/ # CLI
├── internal/ # Compiler (lexer, parser, types, eval, effects)
├── std/ # Standard library (std/io, std/fs, std/json, std/zip, std/xml, etc.)
├── examples/ # Example and reference programs
├── docs/ # Documentation website source
└── design_docs/ # Design documents
License
Apache 2.0 - See LICENSE
AILANG draws inspiration from Haskell, OCaml, Rust, and Idris/Agda.
For AI agents: Deterministic functional language with Hindley-Milner type inference, algebraic effects, and explicit effect tracking. Read AGENTS.md, then use ailang prompt for current language guidance.
AILANG Docs MCP questions
How do I add AILANG Docs MCP to Claude Code?
Run claude mcp add --transport http ailang https://mcp.ailang.sunholo.com/mcp/ in your terminal. Add --scope user to make it available in every project.
How do I add AILANG Docs MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What is AILANG?
AILANG is a purely functional, effect-typed language designed as a deterministic execution substrate for AI-generated code.
How do I use AILANG with Claude Code?
You can add the AILANG bootstrap via the plugin marketplace using the commands /plugin marketplace add sunholo-data/ailang_bootstrap and /plugin install ailang@sunholo-data/ailang_bootstrap.
Does AILANG support LSP?
Yes, the AILANG binary includes an LSP that provides diagnostics, hover types, go-to-definition, references, and document symbols.