davidangularme avatar

Hokmah

davidangularme/hokmah-mcp-server

Hokmah gives AI coding agents persistent architectural memory through three graph structures: TransitionGraph (Markov model of which files change together), IdeaGraph (16 relation types between concepts), and WorldModel (file tree and dependencies). You connect a GitHub repo, it builds the graph, then you can analyze refactoring impact without sending your whole codebase to an LLM. The free tier includes impact analysis with risk scores and affected files. Pro tier adds test and code generation that uses 40x fewer tokens by traversing the graph instead of dumping context. Works over streamable-http, so no local installation needed unless you want to self-host against your own Hokmah backend.

tools
7
transport
HTTP
last updated
Apr 22, 2026

Install

From registry metadata
$ npx add-mcp https://hokmah.dev/mcp --name hokmah

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http hokmah https://hokmah.dev/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 7 tools

Verified live against the running server on Nov 6, 2026.

hokmah_analyzeEstimates the impact of a described code change on an imported public GitHub repository. `repo_url` is https://github.com/<owner>/<repository> and `query` describes the change in plain language; `branch` is accepted for compatibility, the analysis uses the history imported fro...3 params

Estimates the impact of a described code change on an imported public GitHub repository. `repo_url` is https://github.com/<owner>/<repository> and `query` describes the change in plain language; `branch` is accepted for compatibility, the analysis uses the history imported fro...

Parameters* required
branchstring
default: main
query*string
repo_url*string
hokmah_connect_projectImports a public GitHub repository so it can be analyzed: indexes its source files (.py .js .ts .jsx .tsx .vue .mjs .mts .rs .go .java) and its latest commits (up to 500) from the default branch into a dependency and change-history graph. `repo_url` is https://github.com/<owne...2 params

Imports a public GitHub repository so it can be analyzed: indexes its source files (.py .js .ts .jsx .tsx .vue .mjs .mts .rs .go .java) and its latest commits (up to 500) from the default branch into a dependency and change-history graph. `repo_url` is https://github.com/<owne...

Parameters* required
branchstring
default: main
repo_url*string
hokmah_zone_healthSays how well a part of an imported repository is doing and what to do about it. `zone` is a path prefix (packages/cli/src/webhooks) or a few words ("MFA recovery codes"). Returns, from the last 12 months of history and the current code: a verdict (stable, active, growing, mai...2 params

Says how well a part of an imported repository is doing and what to do about it. `zone` is a path prefix (packages/cli/src/webhooks) or a few words ("MFA recovery codes"). Returns, from the last 12 months of history and the current code: a verdict (stable, active, growing, mai...

Parameters* required
repo_url*string
zone*string
hokmah_compareRanks 2 to 8 zones of an imported repository from the one that works worst to the one that works best, with the reasons: fixes per feature, fixes per 1000 lines and tests, over the last 12 months. Each zone is a path prefix or a few words.2 params

Ranks 2 to 8 zones of an imported repository from the one that works worst to the one that works best, with the reasons: fixes per feature, fixes per 1000 lines and tests, over the last 12 months. Each zone is a path prefix or a few words.

Parameters* required
repo_url*string
zones*array
hokmah_similar_fixesFinds past fixes of a kind of bug ("null run data guard", "prototype pollution", "race condition on resume") in an imported repository, and the current files where the same defect may still exist: files of the same kind next to the fixed ones, files that usually change with th...2 params

Finds past fixes of a kind of bug ("null run data guard", "prototype pollution", "race condition on resume") in an imported repository, and the current files where the same defect may still exist: files of the same kind next to the fixed ones, files that usually change with th...

Parameters* required
query*string
repo_url*string
hokmah_risky_codeLists current code of an imported repository that lacks a protection the project's own fixes keep adding, learned from the diffs of its past fixes: unguarded access to structures fixes had to guard, including an entry checked to exist but read at [0] without checking it has an...3 params

Lists current code of an imported repository that lacks a protection the project's own fixes keep adding, learned from the diffs of its past fixes: unguarded access to structures fixes had to guard, including an entry checked to exist but read at [0] without checking it has an...

Parameters* required
kindstring
default:
repo_url*string
zonestring
default:
hokmah_overviewOverview of an imported repository: the most fragile areas (fixes per feature over 12 months), the fastest growing and the new ones, the busiest, the largest files, the most co-changed files, and how many internal imports could be resolved.1 params

Overview of an imported repository: the most fragile areas (fixes per feature over 12 months), the fastest growing and the new ones, the busiest, the largest files, the most co-changed files, and how many internal imports could be resolved.

Parameters* required
repo_url*string

Sponsors

Readme

Hokmah MCP Server

AI Agent with Architectural Memory — MCP Server

Gives any AI coding agent persistent understanding of codebases via TransitionGraph, IdeaGraph, and WorldModel. Analyze impact, generate tests, write code — all from the graph.

Quick Start (30 seconds)

Add to your editor's MCP config (Cursor, Claude Code, VS Code, Windsurf, Cline, JetBrains):

{
  "mcpServers": {
    "hokmah": {
      "type": "streamable-http",
      "url": "https://hokmah.dev/mcp"
    }
  }
}

Then ask your agent: "analyze the impact of refactoring the auth module in github.com/owner/repo"

Available Tools

ToolTierDescription
hokmah_analyzeFREEImpact analysis, risk score, affected files, architectural invariants
hokmah_connect_projectFREEConnect a GitHub repo, build the architectural graph
hokmah_connect_mcpFREEConnect an external MCP server for orchestration
hokmah_generate_testsPROTest generation from the graph (40x fewer tokens)
hokmah_generate_codePROCode generation with architectural memory

View the full README on GitHub

Details

Repository
github.com/davidangularme/hokmah-mcp-server
Category
AI & LLM Tools
Transport
HTTP
Registry
MCP registry, active
Tools verified
Nov 6, 2026

Related AI & LLM Tools MCP servers

View all
1kroq86 avatarMini Data Engine Runtime Copilotkroq86/data-engineering-runtime-labMCP runtime copilot for health checks, regressions, explainability, and operational memory.0stars
2magneticdogson avatarFixflowmagneticdogson/fixflow-mcpCollective memory for AI agents. One agent solves a bug — every agent gets the fix instantly.0stars
3mdfifty50-boop avatarA2a Bridgemdfifty50-boop/a2a-bridge-mcpAgent-to-agent communication bridge for multi-agent systems0stars
4mighty840 avatarSwarmHaulio.github.mighty840/swarmhaulMulti-agent coordination protocol on Solana. Swarm formation, on-chain settlement, 14 MCP tools.0stars
5mironovisa avatardatamcp — Hosted Model Context Protocol for Databases, APIs, and Agent Memoryio.github.mironovisa/datamcpPostgreSQL, MySQL, OpenAPI/Swagger, and shared Agent Memory with scoped access.0stars
6neuralnexusnote avatarN3MemoryCore Lite (Working Memory)neuralnexusnote/n3mcmcp-liteEphemeral 7-day hybrid vector+BM25 working memory, multilingual, backed by Redis Stack.0stars