Skip to content
MCP server

Semahash

Content-addressed definitions that agents can hash, resolve and handshake on

Runs locallyStatus and history
Install
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 semahash

Add to claude_desktop_config.json

{
  "mcpServers": {
    "semahash": {
      "command": "uvx",
      "args": [
        "semahash"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "semahash": {
      "command": "uvx",
      "args": [
        "semahash"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. MCP 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
  2. signafAIde

    MCP server

    Local MCP server to set up, verify and check coverage of signed agent action records

    Runs locally
    • 5 tools
    • Freemium
    • Security
  3. Toolkien

    MCP server

    One 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
  4. Lugh

    MCP server

    Write, check and dry-run Lugh agent programs with policy, budgets and approvals

    Runs locally
    • 5 tools
    • Open source
    • AI models and LLM tooling
  5. HypePaper

    MCP server

    Research papers, benchmarks, citations and topic experts for AI assistants

    • 58 tools
    • Remote
    • Freemium
    • AI models and LLM tooling