Nomos - Deterministic Git & AST Governance for AI Coding Agents

● Active

io.github.mgantlett/nomos

Search AI coding agent governance docs, 42 AST quality gates, Git worktree rules, and benchmarks.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "nomos": {
      "url": "https://sophialabs.ca/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http nomos https://sophialabs.ca/mcp
VS Code
code --add-mcp '{"name":"nomos","type":"http","url":"https://sophialabs.ca/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
4.23.0+1
Registry
active
Published
11/17/2026

Live check

checked Nov 19, 2026, 22:07 UTC
● Working220 msprotocol 2025-06-18v4.27.1toolsresourcesprompts

The endpoint answered the MCP handshake as "sophialabs-nomos-mcp" and listed 7 tools. Answering since Nov 18, 2026.

Context cost ≈ 1.1k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 7 tools.

Tools (7)

tool list changed Nov 19, 2026, 22:07 UTC
  • search_nomos_corpus2 params

    Search Nomos Handbook chapters, Empirical Dispatches, Open-Core Architecture Specs, CLI reference, and comparison tables.

    Show parameters
    • querystringrequiredSearch keywords or technical problem terms
    • sectionstringOptional corpus subset filter
  • inspect_dod_gates3 params

    Inspect the 42 compiled Go/AST Definition of Done gates, ERR_* failure diagnostics, and container/symlink/CapBAC IFC sandbox rules.

    Show parameters
    • gate_idstringOptional gate identifier such as G-01 or G-16
    • lawintegerOptional Canonical Law number (1..7)
    • categorystringOptional category slug: ast, phase, sandbox, security, testing
  • recommend_adoption_plan4 params

    Generate a zero-risk Nomos onboarding plan (nomos xray, Branch Guard, CI SARIF, worktrees, or air-gapped GPU) tailored to repository scale.

    Show parameters
    • languagesarrayRepository languages
    • repo_locintegerApproximate lines of code
    • ci_providerstringOptional CI system such as github or gitlab
    • airgappedbooleanSet true for zero-egress air-gapped local GPU setups
  • compare_governance_approaches1 param

    Compare Nomos against Prompt Wrappers, Style Linters, and Static AGENTS.md / .cursorrules with empirical benchmark receipts.

    Show parameters
    • focusstringOptional capability focus keyword
  • xray_github_repo1 param

    Run a live sub-5s static AST X-Ray against any public GitHub repository (<= 50MB tarball, zero code execution) and return its AI Hangover Score, hotspots, Day-0 nomos.baseline.json, and 4-line GitHub Action.

    Show parameters
    • repostringrequiredPublic GitHub owner/repo slug or URL (for example "go-chi/chi")
  • diagnose_nomos_error2 params

    Resolve any Nomos ERR_* failure code, TC-AGT-* vector, or nomos verify gate rejection into its root cause and non-bypassing 1-turn AST fix.

    Show parameters
    • error_codestringOptional ERR_* identifier such as ERR_CROSS_PLANE_MUTATION or ERR_COGNITIVE_DEBT
    • error_logstringOptional raw error message, gate name, or pre-commit output snippet
  • scaffold_nomos_config4 params

    Generate a schema-valid nomos.yaml configuration, 4-line GitHub Actions SARIF workflow, and Day-0 onboarding commands for any repository.

    Show parameters
    • project_namestringRepository or project slug
    • languagesarrayTarget languages (for example ["typescript", "go", "python"])
    • modestringOnboarding mode: branch (default), local (stealth .git/info/exclude), or worktrees
    • ci_providerstringCI platform for verification workflow output (defaults to github)

Checked by Serverdex with a plain initialize + tools/list call to sophialabs.ca/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 18, 2026
Stars
6
Forks
0
Last push
Nov 18, 2026
License
Apache-2.0

Goai-agentsastclaude-codecode-qualitycoding-agentscursordeveloper-toolsgemini-cligit-hooksgit-worktreegogolangmcpopencodestatic-analysistree-sitter

From the README

Nomos (Νόμος) Agents guess; Git cannot. The deterministic execution substrate between any coding agent and Git. Coding agents optimize for making their prompt finish, even when that means deleting failing tests, returning empty // TODO stubs, editing linter configs, or stuffing new complexity into fragile legacy files. Nomos is a single ~20 MB static Go binary (Apache 2.0, zero cloud account, zero telemetry) that sits between your coding agent (Claude Code, Cursor, OpenCode, Gemini CLI, Antigravity, Windsurf, or Aider) and Git. Just as PostgreSQL placed ACID transactions between applications and raw disk, Nomos places human-authored repository laws underneath machine speed so nothing touches main without passing compiled AST verification on feature branches. Audit in 5 seconds. Guard every branch in one command. Scale when you need it: What happens the next time an agent tries taking a shortcut on a feature branch: Progressive Governance Out of the Box (100% Apache 2.0 Open-Core) Every single-repository governance capability ships locally in the open-source nomos binary with zero crippled commands, and you adopt complexity only as your repo grows: 1. Zero-Init Brownfield X-Ray & Auto-Baseline (nomos xray, nomos init) • Sub-Second Git-Aware Audit (nomos xray .…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://sophialabs.ca/mcp

Alternatives to Nomos - Deterministic Git & AST Governance for AI Coding Agents

Best Developer Tools servers →

The most-starred Developer Tools servers in the index, with their live-check result.

ServerStarsLast pushLive check
REA466,935Nov 2026Local / not checked
GitHub34,466Nov 2026Needs sign-in
Repomix29,280Nov 2026Local / not checked
Compiler Explorer19,188Nov 2026Working
XERJ19,135Nov 2026Local / not checked

Nomos - Deterministic Git & AST Governance for AI Coding Agents: questions people ask

Is Nomos - Deterministic Git & AST Governance for AI Coding Agents a remote or a local MCP server?
According to its entry in the official MCP registry, Nomos - Deterministic Git & AST Governance for AI Coding Agents ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Nomos - Deterministic Git & AST Governance for AI Coding Agents need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 19, 2026. Individual tools may still ask for a key when called.
Is Nomos - Deterministic Git & AST Governance for AI Coding Agents still maintained?
Active: the repository's last commit today. Last push Nov 18, 2026, 6 GitHub stars, Apache-2.0 licence. Read from GitHub on Nov 18, 2026.
What tools does Nomos - Deterministic Git & AST Governance for AI Coding Agents expose?
7 tools as listed by the server itself during the live check, including search_nomos_corpus, inspect_dod_gates, recommend_adoption_plan, compare_governance_approaches, xray_github_repo. The full list with parameters is in the Live check section above.
How do I add Nomos - Deterministic Git & AST Governance for AI Coding Agents to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Developer Tools →

Add the badge to your site

Show visitors that Nomos - Deterministic Git & AST Governance for AI Coding Agents is listed here — it’s also the link we check for a free listing.

Nomos - Deterministic Git & AST Governance for AI Coding Agents — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-mgantlett-nomos?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Nomos - Deterministic Git & AST Governance for AI Coding Agents — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Nomos - Deterministic Git & AST Governance for AI Coding Agents — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-mgantlett-nomos?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.