Skip to content
MCP server

Ai Architect MCP Spec

Deterministic checks that catch invented functions and untraceable claims in specs

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools