Ai Architect MCP Spec
Deterministic checks that catch invented functions and untraceable claims in specs
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.9.0
- Listing updated
- 3 days ago
About Ai Architect MCP Spec
Ai Architect MCP Spec is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Specs written by an agent often name functions that do not exist, quote latency nobody measured or list acceptance criteria that test nothing. This server runs structural checks without a model in the loop: every acceptance criterion must trace to a requirement, no performance claim passes without a measurement, and given the symbols of your code graph it reports inline-code symbols in the spec that none of them resolve.
The registry description counts 17 tools covering PRD verification and host-driven generation with multi-judge consensus. The README says it works in Codex, Gemini CLI, Claude Code and CI, runs on your machine and is written in TypeScript. It is one of three standalone servers from the same author, alongside a memory server and a code-graph server.
It installs from an mcpb bundle over stdio. The wider site notes the spec project is still in development.
Install
Run in a terminal
claude mcp add ai-architect-mcp-spec -- npx -y https://github.com/cdeust/ai-architect-mcp-spec/releases/download/v0.9.0/ai-architect-mcp-spec.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"ai-architect-mcp-spec": {
"command": "npx",
"args": [
"-y",
"https://github.com/cdeust/ai-architect-mcp-spec/releases/download/v0.9.0/ai-architect-mcp-spec.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ai-architect-mcp-spec": {
"command": "npx",
"args": [
"-y",
"https://github.com/cdeust/ai-architect-mcp-spec/releases/download/v0.9.0/ai-architect-mcp-spec.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ai-architect-mcp-spec": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/cdeust/ai-architect-mcp-spec/releases/download/v0.9.0/ai-architect-mcp-spec.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ai-architect-mcp-spec": {
"command": "npx",
"args": [
"-y",
"https://github.com/cdeust/ai-architect-mcp-spec/releases/download/v0.9.0/ai-architect-mcp-spec.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ai-architect-mcp-spec": {
"command": "npx",
"args": [
"-y",
"https://github.com/cdeust/ai-architect-mcp-spec/releases/download/v0.9.0/ai-architect-mcp-spec.mcpb"
]
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- validate_prd_against_graph
- Checks a spec's code symbols against a supplied code graph.
What it does
- Requirement traceability
- Checks acceptance criteria against requirements.
- Measurement rule
- Rejects performance claims without a measurement.
- Symbol resolution
- Flags spec symbols missing from your code graph.
- Deterministic verifier
- No model judges the output.
- Multi-judge consensus
- Generation can be checked by several judges.
- CI friendly
- Works in Codex, Gemini CLI, Claude Code and CI.
Good for
- Verify an AI-drafted PRD before it feeds code generation
- Catch references to functions that do not exist
- Gate spec quality in CI
Pricing
Open source
MIT licensed components
Prices change. Check ai-architect.tools before you buy.
Ai Architect MCP Spec FAQ
Does a model grade the spec?
The structural checks are deterministic with no model in the loop.
How many tools?
17, per the registry entry.
How is it packaged?
As an mcpb bundle released on GitHub, over stdio.
Is it finished?
The site lists AI Architect Spec as still in development.
Is Ai Architect MCP Spec free?
Yes. Ai Architect MCP Spec is open source, so you can use and self-host it for free.
How do I add Ai Architect MCP Spec to Claude Code?
Run this command in your terminal: claude mcp add ai-architect-mcp-spec -- npx -y https://github.com/cdeust/ai-architect-mcp-spec/releases/download/v0.9.0/ai-architect-mcp-spec.mcpb
What are the best alternatives to Ai Architect MCP Spec?
The closest alternatives to Ai Architect MCP Spec are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Ai Architect MCP Spec

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools