AILANG Executor MCP server
Commit Nov 13, 2026Write, type-check, and run AILANG code in a deterministic sandbox with Z3-proved contracts and documentation search.
Also known as sunholo-data/ailang, ailang-executor
- Stars
- 38
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.60.5
- Last commit
- Nov 13, 2026
- License
- Apache-2.0
What is AILANG Executor MCP?
AILANG Executor is an MCP server. Write, type-check, and run AILANG code in a deterministic sandbox with Z3-proved contracts and documentation search.
Summary generated from the project's README
About AILANG Executor MCP server
Writing, type-checking, and executing deterministic code for AI agents is what AILANG Executor enables. This server provides a functional execution substrate designed specifically for machine reasoning rather than human convenience. It allows AI coding agents to work within a purely functional environment featuring Hindley-Milner type inference and a capability-based effect system for managing security permissions like IO, FS, and Net.
Users set up the environment by installing the AILANG CLI locally and adding the bootstrap plugin to clients like Claude Code or OpenAI Codex. The server operates by calling the local ailang executable available on the system path. It provides specific MCP tools including ailang_prompt for syntax guidance, ailang_check for verification, ailang_run for execution, ailang_builtins, and ailang_eval. This setup ensures that any code generated by an agent is deterministic, replayable, and verified through Z3-proved contracts.
What you can do with it
- 1Verify code syntax and idiomsAn AI agent can retrieve the most current language guidance and syntax rules before authoring new files.
- 2Execute code in a secure sandboxDevelopers can run generated code using specific capability-based security permissions to control system access.
- 3Perform type checking and validationAn AI client can use specialized tools to ensure that the functional code adheres to strict type requirements.
- 4Debug and evaluate expressionsAn agent can use the evaluation tool to test logic or interact with the language via a REPL.
Written from the project's README. Every use case is checked against a quote from it.
How to install AILANG Executor MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AILANG Executor MCP in Claude Code
$ claude mcp add --transport http ailang-executor https://executor.ailang.sunholo.com/mcp/connect/Install AILANG Executor MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ailang-executor": {
"url": "https://executor.ailang.sunholo.com/mcp/connect/"
}
}
}Install AILANG Executor MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ailang-executor": {
"type": "http",
"url": "https://executor.ailang.sunholo.com/mcp/connect/"
}
}
}Install AILANG Executor MCP in VS Code CLI
$ code --add-mcp '{"name":"ailang-executor","type":"http","url":"https://executor.ailang.sunholo.com/mcp/connect/"}'Install AILANG Executor MCP in Codex
$ codex mcp add ailang-executor --url https://executor.ailang.sunholo.com/mcp/connect/Install AILANG Executor MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ailang-executor] url = "https://executor.ailang.sunholo.com/mcp/connect/"
Install AILANG Executor MCP in Gemini CLI
$ gemini mcp add -s user --transport http ailang-executor https://executor.ailang.sunholo.com/mcp/connect/Install AILANG Executor MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ailang-executor": {
"url": "https://executor.ailang.sunholo.com/mcp/connect/",
"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 83 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 Executor MCP questions
How do I add AILANG Executor MCP to Claude Code?
Run claude mcp add --transport http ailang-executor https://executor.ailang.sunholo.com/mcp/connect/ in your terminal. Add --scope user to make it available in every project.
How do I add AILANG Executor 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 to Claude Code using the plugin marketplace 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.
Can I run AILANG code interactively?
Yes, you can start an interactive REPL by running the ailang repl command.