arale-code
OfficialIt serves bundled, read-only software-engineering guidance to an MCP-connected coding agent.
Discover valid instruction and procedure IDs/URIs with
list_instructionsandlist_procedures.Read catalogs via
instructions://catalogandarale://catalog.Read individual documents via
instructions://document/{id}andarale://procedure/{id}, including the Guide atarale://procedure/guide.Use the
apply_instructionprompt with an instructionidand nonemptytask.Access four Markdown instructions, one YAML control Guide, and 20 YAML procedures.
It does not execute procedures, modify projects, grant permissions, or make outbound network requests; the agent applies the guidance under its own tools and permissions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@arale-code list the procedures and read the one for writing tests"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
arale-code
Local engineering guidance for coding agents, served through MCP. arale-code gives an agent four reusable instructions, a control Guide and 20 software engineering procedures. The server provides documents; the agent decides what to do with them under its own tools and permissions.

Read the Guide, choose one procedure, then read its full document.
Find the right procedure
Connect an MCP client to the local STDIO server.
Read
arale://procedure/guidefor the selection rules, or calllist_proceduresto discover IDs and resource URIs.Read the selected procedure in full, then apply it to the user’s task within the agent’s existing permissions.
For example, call the list_procedures MCP tool with an empty argument object:
{}It returns a JSON string whose first entry is the Guide (excerpt; the full documents array has 21 entries):
{"schema_version":1,"documents":[{"id":"guide","code":"GUIDE","title":"Control Guide","kind":"guide","uri":"arale://procedure/guide"}]}Read that URI as an MCP resource to get the YAML Guide. Its meta.id is GUIDE and its meta.version is '1.7'. The example shows catalog discovery; it does not cause the server to edit a project.
Related MCP server: CodeContext MCP
Get started
You need Python 3.12 and uv, with the locked dependencies available locally. From the repository root, prepare the environment without a network request:
uv sync --locked --offline --no-python-downloadsThen follow INSTALL.md to register one client and check its live MCP connection. It documents Codex CLI, Claude Code, Cursor, OpenCode and Antigravity CLI, including the local launch command. An offline sync can fail if Python or a locked dependency is missing from the local cache; the installation guide explains what to check before downloading anything.
What is included
Interface | Contents |
Tools |
|
Catalog resources |
|
Resource templates |
|
Prompt |
|
The bundled documents are four Markdown instructions, one YAML Guide and 20 YAML procedures. See the MCP contract for exact IDs, response shapes and errors.
Boundaries and verification
The server is read-only and stateless. It serves bundled guidance over local STDIO; it does not execute procedures, grant permissions or make outbound network requests. The consuming agent remains responsible for any project changes.
Repository tests and an isolated local STDIO package check have verified the bundled interface and Guide 1.7 assets. The five client paths in INSTALL.md are documented installation paths; live discovery in each client has not been verified here. See the verification contract for the checks required after client registration.
Develop and contribute
Prepare the locked environment as above, then run the repository’s quality gates:
uv run ruff check .
uv run ruff format --check .
uv run mypy src tests
uv run pytestFor changes to the MCP interface or bundled documents, read the server contract and quality gates, and include the relevant verification with your proposed change. For installation questions, start with INSTALL.md.
License and maintainer
Maintained by Scala Core. Licensed under Apache 2.0; see NOTICE for attribution.
Available Tools
2 toolslist_instructionsList InstructionsARead-onlyIdempotent
List valid engineering-instruction IDs and their resource URIs. Call this before requesting an instruction when the ID is not already known.
Inputs: no named parameters. Returns: result
list_proceduresList ProceduresARead-onlyIdempotent
List the Arale control guide and procedures with their IDs and resource URIs. Call this before reading a procedure when the ID is not already known.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are mostly distinct: one lists procedures/control-guide entries and the other lists engineering-instruction IDs. They share a very similar list-by-ID/URI pattern, but the descriptions make the resource type clear enough to avoid most confusion.
Both tools follow the same predictable list_noun convention. There are no naming inconsistencies across the set.
Two tools is thin for a server surface, and both only list identifiers rather than offering broader procedure/instruction interaction. The count is borderline rather than clearly wrong, but it feels under-scoped.
The surface only lists procedure and instruction IDs/URIs; there are no tools to actually read, fetch, or operate on a procedure or instruction. Descriptions imply later reading/requesting, but the tool set does not provide those operations, creating a significant dead end.
Maintenance
Related MCP Connectors
Create guides as MCP servers to instruct coding agents to use your software (library, API, etc).
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Read-only MCP server that answers questions about turva.dev from its published data. Five tools return JSON: the service catalog with prices, contact and operator details, engagement principles and dated agent-readiness and security evidence with verification links. Connect over Streamable HTTP. You need no API key. The server does not scan other websites or run audits.
Guarded MCP server for agent-readable business truth, provenance, readiness, and discovery.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides a stdio MCP bridge for coding agents to query and record engineering knowledge locally, preserving debugging history, failed attempts, and verified solutions.MIT
- AlicenseNot gradedqualityCmaintenanceEnables coding agents to search local repositories and retrieve bounded, cited source chunks, look up full indexed chunks, and inspect index statistics through read-only MCP tools over stdio.MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to read, navigate, and query long-term memory stored as readable, reviewable source files, exposing paged catalogs, indexed searches that explain their misses, bounded relation traces, link diagnostics, raw file access, and preflight checks of drafts against MUST constraints. It serves this read-only by default over stdio so any MCP client can start from a memory catalog and keep reading toward the answer instead of relying on a single similarity guess.1MIT
- AlicenseAqualityCmaintenanceEnables AI coding agents to consult a project's Git-versioned Markdown knowledge base over local stdio — checking knowledge health, listing the catalog, searching topics, and reading guides before acting. Access stays read-only, so project guidance, decisions, and lessons learned remain shared with human teammates and traceable beside the code.41MIT