# Semahash

> Semahash is an open-source MCP server for ai models and llm tooling. Content-addressed definitions that agents can hash, resolve and handshake on. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://semahash.org
- **Repository:** https://github.com/emergent-wisdom/sema
- **MCP Registry name:** io.github.emergent-wisdom/semahash
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add semahash -- uvx semahash
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "semahash": {
      "command": "uvx",
      "args": [
        "semahash"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "semahash": {
      "command": "uvx",
      "args": [
        "semahash"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "semahash": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "semahash"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "semahash": {
      "command": "uvx",
      "args": [
        "semahash"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "semahash": {
      "command": "uvx",
      "args": [
        "semahash"
      ]
    }
  }
}
```

## Tools

- `sema_search`: Search the vocabulary.
- `sema_lookup`: Look up a specific pattern.
- `sema_handshake`: Verify shared meaning at a boundary.

## 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

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/semahash
