Semahash
Content-addressed definitions that agents can hash, resolve and handshake on
- Pricing
- Open source
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.10.0
- Listing updated
- 2 days ago
About Semahash
Semahash is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.
Sema's core idea fits in one line from its site: a word is the hash of its canonical definition. Two agents that share a name can check they mean the same thing instead of trusting it. The README is careful about the limits: matching full references proves identity of the hashed content, while semantic equivalence, correctness and enforcement are separate questions.
The worked example is a vocabulary of Pattern Cards, which the registry puts at 617 reusable reasoning patterns such as StateLock. An agent can search the vocabulary, resolve a handle, show a definition, browse the graph skeleton and perform a handshake that fails closed if the definitions do not match. The README names sema_search, sema_lookup and sema_handshake and says nine more tools exist.
It runs locally over stdio, installed with uvx or pip, and a Claude Code plugin adds a skill. Users can build a private registry with sema init and no maintainer approval. The project has a paper on Zenodo and separate licences for code and content.
Install
Run in a terminal
claude mcp add semahash -- uvx semahashAdd to claude_desktop_config.json
{
"mcpServers": {
"semahash": {
"command": "uvx",
"args": [
"semahash"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"semahash": {
"command": "uvx",
"args": [
"semahash"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"semahash": {
"type": "stdio",
"command": "uvx",
"args": [
"semahash"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"semahash": {
"command": "uvx",
"args": [
"semahash"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"semahash": {
"command": "uvx",
"args": [
"semahash"
]
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- sema_search
- Search the vocabulary.
- sema_lookup
- Look up a specific pattern.
- sema_handshake
- Verify shared meaning at a boundary.
What it does
- Vocabulary search
- Searches the pattern vocabulary by keyword.
- Resolve and show
- Looks up a pattern by handle and prints its full definition.
- Fail-closed handshake
- Verifies two sides use the same definition before proceeding.
- Private registries
- Builds a local vocabulary with sema init and sema use.
- Graph browsing
- Shows the structure of the pattern graph.
- Claude Code plugin
- Bundles the server with a usage skill.
Good for
- Check that two agents share the same definition of a term
- Search known coordination patterns by name
- Embed verifiable handles in agent messages
- Keep a private library of reasoning patterns
Pricing
Open source
Open source; separate licences for code and content
Prices change. Check semahash.org before you buy.
Semahash FAQ
How do I install it?
Run it with uvx from the semahash[mcp] package or pip install semahash[mcp].
Does a matching hash prove the meaning is correct?
No. The README says it establishes identity of the hashed content only.
How many patterns are there?
The registry entry says 617.
Can I use my own vocabulary?
Yes. The README shows creating a private registry database with sema init.
Is Semahash free?
Yes. Semahash is open source, so you can use and self-host it for free.
How do I add Semahash to Claude Code?
Run this command in your terminal: claude mcp add semahash -- uvx semahash
What are the best alternatives to Semahash?
The closest alternatives to Semahash are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.
Alternatives to Semahash

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

signafAIde
MCP serverLocal MCP server to set up, verify and check coverage of signed agent action records
Runs locally- 5 tools
- Freemium
- Security

Toolkien
MCP serverOne MCP gateway for all your MCP servers, with code mode, permissions and audit
Not checked yet- 3 tools
- Remote
- Open source
- AI models and LLM tooling
Lugh
MCP serverWrite, check and dry-run Lugh agent programs with policy, budgets and approvals
Runs locally- 5 tools
- Open source
- AI models and LLM tooling
HypePaper
MCP serverResearch papers, benchmarks, citations and topic experts for AI assistants
- 58 tools
- Remote
- Freemium
- AI models and LLM tooling

One compact entry point that finds, describes and runs hundreds of pay-per-call data tools
- 3 tools
- Remote
- Freemium
- Developer tools