AILANG Executor

Write, type-check and run AILANG in a sandbox, with Z3-proved contracts and docs search.

Should I use this

Quality & Safety

A
Description quality
96%
Schema completeness
74%
Naming quality
81%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (2)

  • LOWTool 'docs_nav' description lacks action verbin docs_nav
  • LOWTool 'effects_catalog' description lacks action verbin effects_catalog

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,410Tokens (tool definitions)
~382 BTypical response size
Significant attention impact (2.66% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "ailang-executor": {
      "url": "https://executor.ailang.sunholo.com/mcp/connect/"
    }
  }
}

Remote endpoints

https://executor.ailang.sunholo.com/mcp/connect/streamable-http

What it can do

Tool inventory

Tools (28)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢ailang_builtins(search)

List AILANG builtin functions with documentation, grouped by module. `search` filters lines case-insensitively; empty returns everything.

Input Schema

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string"
    }
  },
  "required": [
    "search"
  ]
}
🟢ailang_check(code)

Type-check AILANG source. `code` is a whole module; the module line may be omitted or be `module main`. Returns the ai-check JSON report on stdout: check.passed and check.errors (with locations and fixes), and verify: each function's requires/ensures proved with Z3 (verify.results: verified, counterexample with a witness, or inconclusive after 5s per function). Only `pure` functions (or `! {}`) are proved; others report skipped/NOT_PURE. `verification` names the overall result; "unavailable" means this server had no solver, so the code was type-checked only and its contracts were not proved (prove them locally with `ailang verify`).

Input Schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    }
  },
  "required": [
    "code"
  ]
}
🟢ailang_eval(expression)

Evaluate one pure AILANG expression and print it with show(). Builtins are in scope; for stdlib functions (map, filter, ...) use ailang_run with explicit imports.

Input Schema

{
  "type": "object",
  "properties": {
    "expression": {
      "type": "string"
    }
  },
  "required": [
    "expression"
  ]
}
🟢ailang_prompt

Call this FIRST: the AILANG teaching prompt (syntax rules, templates, stdlib map). AILANG is not in your training data the way Python is; code written without this prompt rarely type-checks.

Input Schema

{
  "type": "object",
  "properties": {},
  "required": []
}
🟢ailang_run(code)

Run AILANG source in the hosted sandbox. Entry point is `main`, with no arguments. Only the IO capability is granted (println works; FS, Net, Process, Env and AI are refused by name before the program starts), and the run is killed at the policy timeout. stdout is the program's output; stderr carries the policy decision JSON.

Input Schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    }
  },
  "required": [
    "code"
  ]
}
🟢ailang_versions

List all AILANG versions the server can answer for.

Input Schema

{
  "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.

Input Schema

{
  "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}

Input Schema

{
  "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.

Input Schema

{
  "type": "object",
  "properties": {
    "sinceVersion": {
      "type": "string"
    }
  },
  "required": [
    "sinceVersion"
  ]
}
🟢changelog_for_version(version)

What changed in a given release (added/changed/fixed/breaking).

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "type": "object",
  "properties": {
    "features": {
      "type": "string"
    },
    "forVersion": {
      "type": "string"
    },
    "status": {
      "type": "string"
    }
  },
  "required": [
    "features",
    "status",
    "forVersion"
  ]
}
🟢executor_whoami

Which account this connection is signed in as (its user ID) and which app connected it (for example claude.ai or chatgpt.com).

Input Schema

{
  "type": "object",
  "properties": {},
  "required": []
}
🟢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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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".

Input Schema

{
  "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.

Input Schema

{
  "type": "object",
  "properties": {},
  "required": []
}
🟢stdlib_module(forVersion, name)

Full module: exports + signatures + docstrings.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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"
  ]
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded28 tools