Hokmah

io.github.davidangularmePublished by GitHub account davidangularmev1.0.0Updated Oct 24, 2026

AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Hokmah is a remote MCP server that imports a public GitHub repository into an architectural graph so an assistant can estimate the impact of a described code or

What you can do
Import a public GitHub repository and index its source files and recent commits into a dependency and change-history graph, with a branch parameter accepted for compatibility while the default branch is used. Estimate the impact of a described code change on an imported repository, returning a risk score, affected files and architectural invariants. Connect an external MCP server for orchestration. The README also lists pro-tier test generation and code generation from the graph, which are not among the tools declared here.
When to use it
Useful when you want an assistant to reason about the blast radius of a refactor or change in a public GitHub repository without sending the whole codebase to a model, and when you want a persistent architectural view of that repository across sessions.
Requirements
A remote streamable HTTP endpoint; no local runtime or package is needed. The repository must be public on GitHub. No authentication is declared for the hosted endpoint. Self-hosting requires Python, an upstream Hokmah backend, and the HOKMAH_API_BASE, HOKMAH_MCP_PORT and HOKMAH_PRO_KEYS settings.
Before you install
Importing a repository sends its source files and commit history to a third-party hosted service. The README describes a paid Pro tier for test and code generation using your own LLM key, and a Pro key obtained from the vendor; the declared tools do not include these. Analysis results are estimates from a graph model, not verified test results.

Installation

In SourceWeft

  1. Open Hokmah in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.davidangularme%2Fhokmah/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

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):

json
{  "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

How It Works

Hokmah builds a persistent architectural graph from your codebase:

  • TransitionGraph — Markov model of code changes (which files change together)
  • IdeaGraph — 16 relation types between concepts
  • WorldModel — File tree, dependencies, symbols

When you ask "what's the impact of changing X?", Hokmah traverses the graph instead of sending your entire codebase to an LLM. That's why analyze is free (zero LLM tokens) and generate uses 40x fewer tokens.

Pricing

  • Free — hokmah_analyze + hokmah_connect_project + hokmah_connect_mcp (unlimited)
  • Pro — hokmah_generate_tests + hokmah_generate_code (BYOK — bring your own LLM key)

Get a Pro key at hokmah.dev.

Editor Setup

  • Cursor — Settings → MCP → Add server → paste config
  • Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Code — claude mcp add hokmah --transport streamable-http --url https://hokmah.dev/mcp
  • VS Code (Copilot) — .vscode/mcp.json in project root
  • Windsurf — ~/.windsurf/mcp.json
  • Cline — Settings → MCP Servers → Add
  • JetBrains — Settings → Tools → AI Assistant → MCP Servers

Self-Hosting

The hosted server at https://hokmah.dev/mcp is the recommended way to use Hokmah. To run the server yourself against your own Hokmah backend:

bash
pip install -r requirements.txtcp pro_keys.example.json pro_keys.json  # edit with your real PRO keysHOKMAH_API_BASE=http://localhost:8000 python mcp_server.py

Environment variables:

  • HOKMAH_API_BASE — upstream Hokmah API (default http://localhost:8000)
  • HOKMAH_MCP_PORT — port to listen on (default 8001)
  • HOKMAH_PRO_KEYS — path to the PRO keys JSON file (default /home/vpm/mcp-server/pro_keys.json)

A reference systemd unit is provided in hokmah-mcp.service.

Built by

Catalyst AI Research · Haifa, Israel

License

MIT

Source: README.md at commit 78d5b00

Tools

2

hokmah_analyze

Analyze Change Impact

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 from the default branch. Returns a risk assessment with the files, symbols and modules likely to be affected and related commits, computed from the repository graph without a language model.

Parametersqueryrequiredbranchrepo_urlrequired

hokmah_connect_project

Import Public GitHub Repository

Imports a public GitHub repository so it can be analyzed: indexes its source files (.py .js .ts .jsx .tsx .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/<owner>/<repository>; `branch` is accepted for compatibility. A repository already imported is not imported again. Returns the project id and the number of commits and files ingested.

Parametersbranchrepo_urlrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts