archstone — Claude Code MCP server: what it does, how to install
Compiler that turns declarative YAML specs and OpenAPI schemas into ready-to-use MCP tools without handwritten integration glue code.
claude mcp add archstone -- npx -y @archstone/cliWhat archstone does
Archstone takes business capability declarations written in CDL (Capability Definition Language) and lowers them to an intermediate representation. Bindings map these definitions directly to REST endpoints or PostgreSQL databases, which archstone serve then exposes over stdio or HTTP as agent tools. The archstone init command can also scaffold a manifest directly from an OpenAPI file or a Postgres schema.
The compiler filters data flow in both directions. Backend attributes omitted from the manifest never reach the prompt context. Invented fields produced by an LLM get rejected before reaching production endpoints. For continuous integration, archstone verify replays recorded fixtures against target backends to spot API drift.
Running the CLI requires Node 22+. Both archstone build and archstone serve operate entirely offline without network pings or API tokens.
What it helps with
- turn an OpenAPI document into MCP tools without handwritten glue
- prevent undeclared backend database columns from leaking into agent prompts
- block hallucinated model arguments before reaching internal APIs
- catch backend contract drift with automated fixture replays
Example prompts for the agent
- Draft an Archstone capability manifest from
openapi.yamlfor the catalog domain - Validate and compile manifests inside
manifestusingarchstone apply - Serve MCP tools via stdio from directory
manifestusingarchstone serve
How to install archstone
Platform CLI
claude mcp add archstone -- npx -y @archstone/cliPlatform CLI
codex mcp add archstone -- npx -y @archstone/cliConfig file
{
"mcpServers": {
"archstone": {
"command": "npx",
"args": [
"-y",
"@archstone/cli"
]
}
}
}Config file
{
"servers": {
"archstone": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@archstone/cli"
]
}
}
}Platform CLI
gemini mcp add archstone npx -y @archstone/cliStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about archstone
How to install archstone in Claude Code?
Run claude mcp add archstone -- npx -y @archstone/cli in your terminal. Ensure your system has Node 22+ installed.
What does archstone do?
It compiles declarative capability manifests into standard MCP tools. It translates schemas, validates inputs, and routes requests to REST services or SQL databases.
Does archstone require external cloud accounts or tokens?
No, core commands like archstone build and archstone serve function completely offline. They execute locally without remote network requests or account credentials.
