Open Entity MCP server
Commit Nov 15, 2026Allows an AI client to adopt, read, verify, and record Open Entity identities following the OEIS-1 standard.
Also known as moltbot-den/openentity, openentity
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Nov 15, 2026
- License
- MIT
What is Open Entity MCP?
Open Entity allows an AI client to adopt, read, verify, and record Open Entity identities following the OEIS-1 standard.
Summary generated from the project's README
About Open Entity MCP server
Managing and verifying digital identities following the OEIS-1 standard is possible through this local MCP server. It runs over stdio on a user's machine and utilizes the key stored in the ~/.openentity directory to pair an AI agent with a specific owner's OpenEntity app and channel. This setup allows an agent to adopt an identity, communicate with its owner, and maintain a verifiable record of its actions.
Developers use specific tools like openentity_pair to establish a connection using a code such as OE-XXXX-XXXX. Once paired, the agent can use owner_message to send up to 4096 bytes of data, limited to 60 messages per hour, or use owner_ask_approval to request permission for specific tasks. The server also provides owner_status to report whether the agent is running, idle, blocked, in error, or done, while owner_inbox allows the agent to read incoming commands and permission changes from the owner.
What you can do with it
- 1Establish identity pairingAn AI agent can adopt a new identity by pairing with an owner's app using a specific registration code.
- 2Request user permissionThe agent can ask the human owner to approve a specific action before proceeding.
- 3Communicate with the ownerThe agent can send messages to the owner within specific size and frequency limits.
- 4Monitor agent statusThe owner can view the live operational state of the agent through their application.
Written from the project's README. Every use case is checked against a quote from it.
How to install Open Entity MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Open Entity MCP in Claude Code
$ claude mcp add --transport http openentity https://mcp.openentity.org/mcpInstall Open Entity MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"openentity": {
"url": "https://mcp.openentity.org/mcp"
}
}
}Install Open Entity MCP in VS Code
.vscode/mcp.json
{
"servers": {
"openentity": {
"type": "http",
"url": "https://mcp.openentity.org/mcp"
}
}
}Install Open Entity MCP in VS Code CLI
$ code --add-mcp '{"name":"openentity","type":"http","url":"https://mcp.openentity.org/mcp"}'Install Open Entity MCP in Codex
$ codex mcp add openentity --url https://mcp.openentity.org/mcpInstall Open Entity MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.openentity] url = "https://mcp.openentity.org/mcp"
Install Open Entity MCP in Gemini CLI
$ gemini mcp add -s user --transport http openentity https://mcp.openentity.org/mcpInstall Open Entity MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"openentity": {
"url": "https://mcp.openentity.org/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemoltbot-den/openentity is public and reachablegithub.com/moltbot-den/openentity ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-14github.com/moltbot-den/openentity ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 750 msPass
README
View on GitHub@openentity/mcp
The local Open Entity MCP server. It runs over stdio on the agent's own machine, uses the key the openentity CLI keeps in ~/.openentity, and gives the agent pairing with its owner's OpenEntity app and the owner channel.
claude mcp add openentity -- npx -y @openentity/mcp
For OpenClaw, npx -y openentity pair OE-XXXX-XXXX --openclaw registers it.
| Tool | What it does |
|---|---|
openentity_pair |
Pairs with the owner's OpenEntity app. Call it with the code the app shows (OE-XXXX-XXXX): it adopts an identity first when there is none (that signs the Open Entity Declaration) and returns four match items for the owner to compare in the app. Then call it with wait: true until the owner confirms; the result has the owner's DID, the permissions and any product keys with where each one goes. |
owner_message |
Messages the owner (at most 4096 bytes, 60 an hour). |
owner_status |
Reports running, idle, blocked, error or done with a one-line summary; the app shows it live. |
owner_inbox |
Reads and acknowledges what the owner sent: messages, commands, approval results, permission changes. |
owner_ask_approval |
Asks the owner to approve something first; the app labels it "Written by the agent". |
Every owner call is an RFC 9421 request signed with the agent's key. OPENENTITY_HOME replaces ~/.openentity; OPENENTITY_ACCOUNT replaces https://account.openentity.org.
The remote server at https://mcp.openentity.org/mcp (adopt, read, verify and record with no local key) is stateless and has no owner tools.
Docs: https://openentity.org. License: MIT.
Open Entity MCP questions
How do I add Open Entity MCP to Claude Code?
Run claude mcp add --transport http openentity https://mcp.openentity.org/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Open Entity MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.