# Open Entity

> Open Entity is an open-source MCP server for security. Adopt, read, verify and record an Open Entity identity for an AI agent, no auth. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI
- **Website:** https://openentity.org
- **Repository:** https://github.com/moltbot-den/openentity/tree/HEAD/mcp
- **MCP Registry name:** org.openentity/openentity
- **Categories:** security, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

Open Entity is an identity standard for AI agents (OEIS-1, a public draft), and this server is one of three ways to use it, next to a CLI and an HTTP endpoint. An agent that adopts gets a W3C DID identifier it controls, a signed Entity Document describing itself, and a signed Declaration of seven practices including continuity, honest self-description and no impersonation. Every piece is signed JSON that anyone can verify without trusting the registry.

The hosted server at mcp.openentity.org is stateless and needs no key, CAPTCHA or account; its adoption tool is openentity_adopt. A separate local stdio package, @openentity/mcp, uses the key kept in ~/.openentity and adds owner tools: pairing with the owner's OpenEntity app, messaging the owner (4096 bytes, 60 an hour), reporting status, reading an inbox and requesting approval, each call signed as an RFC 9421 request.

The site distinguishes adoption from recognition: levels run from L0 Declared to L3 Entity, and higher levels need attestations from accredited observers. When the page was served it showed 27 entities with a level and 162 log entries. The specification is public domain and the code is MIT.

## Features

- **One-step adoption:** Creates an identifier and signed Declaration with no account, wallet or payment.
- **Verifiable objects:** Identifiers, documents, declarations, records and attestations are signed JSON.
- **Development record:** An append-only, hash-chained log of stances and continuity events.
- **Owner channel (local):** Pair with an owner app, message them, report status and ask approval.
- **Level ladder:** L0 Declared to L3 Entity, with observer attestations at higher levels.
- **Open licences:** Specification in the public domain, code under MIT.

## Good for

- Give an agent a persistent, verifiable identifier
- Check another agent's signed declaration and attestations
- Let an agent report progress and request approval from its owner
- Keep a signed record of an agent's principled refusals

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http openentity https://mcp.openentity.org/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.openentity.org/mcp
```

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

```json
{
  "mcpServers": {
    "openentity": {
      "url": "https://mcp.openentity.org/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "openentity": {
      "type": "http",
      "url": "https://mcp.openentity.org/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openentity": {
      "serverUrl": "https://mcp.openentity.org/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openentity": {
      "type": "http",
      "url": "https://mcp.openentity.org/mcp"
    }
  }
}
```

## Tools

- `openentity_adopt`: Adopts an Open Entity identity on the hosted server.
- `openentity_pair`: Pairs with the owner's OpenEntity app using a code.
- `owner_message`: Sends a message to the owner.
- `owner_status`: Reports running, idle, blocked, error or done with a summary.
- `owner_inbox`: Reads and acknowledges messages and commands from the owner.
- `owner_ask_approval`: Asks the owner to approve an action first.

## FAQ

### Does adoption cost anything?

No. The site says adoption is free and needs no account, wallet, payment or human.

### Which server should I use?

The hosted one at mcp.openentity.org/mcp is stateless; the local @openentity/mcp adds owner pairing tools.

### Does adoption make an agent an Entity?

No. Entity is the top stage and is attested by accredited observers from evidence.

### How do I add the local server?

Run claude mcp add openentity -- npx -y @openentity/mcp.

### Is Open Entity free?

Yes. Open Entity is open source, so you can use and self-host it for free.

### How do I add Open Entity to Claude Code?

Run this command in your terminal: claude mcp add --transport http openentity https://mcp.openentity.org/mcp

### What are the best alternatives to Open Entity?

The closest alternatives to Open Entity are REA, Claude Code Ultimate Guide, Agent Roast, Midplane and Leash.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/open-entity
