
Hokmah
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 hokmahRun 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/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 7 toolsVerified 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...
branchstringquery*stringrepo_url*stringhokmah_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...
branchstringrepo_url*stringhokmah_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...
repo_url*stringzone*stringhokmah_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.
repo_url*stringzones*arrayhokmah_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...
query*stringrepo_url*stringhokmah_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...
kindstringrepo_url*stringzonestringhokmah_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.
repo_url*stringSponsors
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
| Tool | Tier | Description |
|---|---|---|
hokmah_analyze | FREE | Impact analysis, risk score, affected files, architectural invariants |
hokmah_connect_project | FREE | Connect a GitHub repo, build the architectural graph |
hokmah_connect_mcp | FREE | Connect an external MCP server for orchestration |
hokmah_generate_tests | PRO | Test generation from the graph (40x fewer tokens) |
hokmah_generate_code | PRO | Code generation with architectural memory |
Details
- Repository
- github.com/davidangularme/hokmah-mcp-server
- Category
- AI & LLM Tools
- Transport
- HTTP
- Registry
- MCP registry, active
- Tools verified
- Nov 6, 2026