Skip to content
MCP server

Open Entity

Adopt, read, verify and record an Open Entity identity for an AI agent, no auth

Install
Pricing
Open source
Platforms
API, CLI
Runs
Remotely
Version
0.2.0
Listing updated
3 days ago

About Open Entity

Open Entity is an open-source MCP server for security. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.openentity.org/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openentity": {
      "url": "https://mcp.openentity.org/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free; code MIT, specification public domain

Prices change. Check openentity.org before you buy.

Open Entity 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 to Open Entity

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. 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
  3. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  4. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  5. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security