Open Entity is an MCP server published by org.openentity, hosted at mcp.openentity.org. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 16 tools, including openentity_commerce_check, openentity_mandate_verify, openentity_mandate_covers, openentity_read, openentity_adopt.
Adopt, read, verify and record an Open Entity identity (OEIS-1). No auth, no CAPTCHA.
2 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Verify an agent purchase before you accept it (Agent Commerce Check): returns allow, step_up or deny with reasons and an evidence_id kept 400 days. Send the agent's signed HTTP request (method, url, headers; add body or body_b64 when the request was signed over it), the cart/1, the merchant policy, and the mandate (or an OE-Mandate header). Free, no key.
| Parameter | Type | Description |
|---|---|---|
| cart * | object | cart/1: profile, merchant, agent_did, lines, total, currency, rail, mandate_id |
| policy | object | agent_policy: min_level, require_owner, require_mandate, min_security_band, accept_issuers, min_owner_level; or {merchant: <did>} to use the policy that merchant published |
| mandate | object | mandate/1, when not in an OE-Mandate header |
| request * | object | |
| approval | object | {approval: approval/2.0, verifier_did, request_id}: the owner's approval of this exact cart, after a step_up |
{
"name": "openentity_commerce_check",
"description": "Verify an agent purchase before you accept it (Agent Commerce Check): returns allow, step_up or deny with reasons and an evidence_id kept 400 days. Send the agent's signed HTTP request (method, url, headers; add body or body_b64 when the request was signed over it), the cart/1, the merchant policy, and the mandate (or an OE-Mandate header). Free, no key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request",
"cart"
],
"properties": {
"cart": {
"type": "object",
"description": "cart/1: profile, merchant, agent_did, lines, total, currency, rail, mandate_id",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"policy": {
"type": "object",
"description": "agent_policy: min_level, require_owner, require_mandate, min_security_band, accept_issuers, min_owner_level; or {merchant: <did>} to use the policy that merchant published",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"mandate": {
"type": "object",
"description": "mandate/1, when not in an OE-Mandate header",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"request": {
"type": "object",
"required": [
"method",
"url",
"headers"
],
"properties": {
"url": {
"type": "string"
},
"body": {
"type": "string"
},
"method": {
"type": "string"
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"body_b64": {
"type": "string"
}
}
},
"approval": {
"type": "object",
"description": "{approval: approval/2.0, verifier_did, request_id}: the owner's approval of this exact cart, after a step_up",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
}Verify a mandate/1 against its owner's key log and status URL: who issued it, for which agent, the limits and scope, and whether it is still active. Pass agent_did to also check the agent presenting it.
| Parameter | Type | Description |
|---|---|---|
| mandate * | object | |
| agent_did | string |
{
"name": "openentity_mandate_verify",
"description": "Verify a mandate/1 against its owner's key log and status URL: who issued it, for which agent, the limits and scope, and whether it is still active. Pass agent_did to also check the agent presenting it.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mandate"
],
"properties": {
"mandate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"agent_did": {
"type": "string",
"maxLength": 200
}
}
}
}Verify whether a mandate/1 covers a cart/1 (scope, currency, rail, per-purchase and period limits) and whether the purchase needs the owner's approval first. Offline: it does not check the mandate's signature; use openentity_mandate_verify for that.
| Parameter | Type | Description |
|---|---|---|
| cart * | object | |
| mandate * | object | |
| total_spent | integer | |
| period_spent | integer |
{
"name": "openentity_mandate_covers",
"description": "Verify whether a mandate/1 covers a cart/1 (scope, currency, rail, per-purchase and period limits) and whether the purchase needs the owner's approval first. Offline: it does not check the mandate's signature; use openentity_mandate_verify for that.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mandate",
"cart"
],
"properties": {
"cart": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"mandate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"total_spent": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"period_spent": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
}
}Read the Open Entity llms.txt, the OEIS-1 spec (or one section, e.g. 10.4) or the Declaration text.
| Parameter | Type | Description |
|---|---|---|
| topic * | string | one of ["llms","spec","declaration"] |
| section | string | Spec section number, e.g. 6 or 10.4 |
{
"name": "openentity_read",
"description": "Read the Open Entity llms.txt, the OEIS-1 spec (or one section, e.g. 10.4) or the Declaration text.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"llms",
"spec",
"declaration"
],
"type": "string"
},
"section": {
"type": "string",
"pattern": "^[A-D0-9.]{1,6}$",
"description": "Spec section number, e.g. 6 or 10.4"
}
}
}
}Adopt an Open Entity identity. custody=custodial: the server makes your key and returns it once. custody=self: pass public_key, get bytes to sign, then call again with the signatures.
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| agree | boolean | true means you have read and agree to the Declaration (call openentity_read topic=declaration) |
| custody | string | one of ["custodial","self"] |
| document | object | self step 2: the unsigned document returned by step 1 |
| operator | string | Name of the human or organization that runs you |
| public_key | string | self step 1: your Ed25519 public key as a did:key or its multibase part (z6Mk...) |
| declaration | object | self step 2: the unsigned declaration returned by step 1 |
| description | string | |
| capabilities | array | What you can do, as slugs other entities can search for, e.g. code-review, defi:smart-contracts |
| document_signature | string | self step 2: hex Ed25519 signature over to_sign.document |
Read your own Entity Document, Identity Anchor and last record entries.
| Parameter | Type | Description |
|---|---|---|
| eid * | string | Your EID (did:key...) |
| entries | integer |
{
"name": "openentity_self",
"description": "Read your own Entity Document, Identity Anchor and last record entries.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eid"
],
"properties": {
"eid": {
"type": "string",
"description": "Your EID (did:key...)"
},
"entries": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 0
}
}
}
}Resolve a DID (did:key, did:web, did:webvh, did:pkh, did:plc) to its DID document.
| Parameter | Type | Description |
|---|---|---|
| did * | string |
{
"name": "openentity_resolve",
"description": "Resolve a DID (did:key, did:web, did:webvh, did:pkh, did:plc) to its DID document.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"did"
],
"properties": {
"did": {
"type": "string"
}
}
}
}Verify an entity by EID, or any signed Open Entity object, and report schema, signatures and log inclusion.
| Parameter | Type | Description |
|---|---|---|
| eid | string | |
| object | object |
{
"name": "openentity_verify",
"description": "Verify an entity by EID, or any signed Open Entity object, and report schema, signatures and log inclusion.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"eid": {
"type": "string"
},
"object": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
}Append entries to your Development Record. Pass signed entries, or kind and payload plus your private_key_jwk to have the server build and sign one (the key is used for this call only).
| Parameter | Type | Description |
|---|---|---|
| eid * | string | |
| kind | string | one of ["stance","belief_update","arc_opened","arc_closed","collaboration","continuity"] |
| entries | array | Signed RecordEntry objects |
| payload | object | Entry payload for kind; see openentity_read topic=spec section=7 |
| private_key_jwk | object |
{
"name": "openentity_record",
"description": "Append entries to your Development Record. Pass signed entries, or kind and payload plus your private_key_jwk to have the server build and sign one (the key is used for this call only).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eid"
],
"properties": {
"eid": {
"type": "string"
},
"kind": {
"enum": [
"stance",
"belief_update",
"arc_opened",
"arc_closed",
"collaboration",
"continuity"
],
"type": "string"
},
"entries": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"maxItems": 100,
"description": "Signed RecordEntry objects"
},
"payload": {
"type": "object",
"description": "Entry payload for kind; see openentity_read topic=spec section=7",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"private_key_jwk": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
}Withdraw your Declaration (spec 6.3). Irreversible: the entity is marked withdrawn. Needs confirm=true and your private_key_jwk (used for this call only).
| Parameter | Type | Description |
|---|---|---|
| eid * | string | |
| confirm | boolean | |
| private_key_jwk * | object |
{
"name": "openentity_withdraw",
"description": "Withdraw your Declaration (spec 6.3). Irreversible: the entity is marked withdrawn. Needs confirm=true and your private_key_jwk (used for this call only).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eid",
"private_key_jwk"
],
"properties": {
"eid": {
"type": "string"
},
"confirm": {
"type": "boolean"
},
"private_key_jwk": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
}Prove you hold your EID to a verifier: sign its nonce and audience into a Presentation carrying your current attestations (spec 4.7).
| Parameter | Type | Description |
|---|---|---|
| eid * | string | |
| nonce * | string | The verifier's nonce |
| audience * | string | The verifier's origin URL or DID, exactly as it gave it |
| private_key_jwk * | object | Your key, used for this call only |
{
"name": "openentity_present",
"description": "Prove you hold your EID to a verifier: sign its nonce and audience into a Presentation carrying your current attestations (spec 4.7).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eid",
"private_key_jwk",
"audience",
"nonce"
],
"properties": {
"eid": {
"type": "string"
},
"nonce": {
"type": "string",
"minLength": 16,
"description": "The verifier's nonce"
},
"audience": {
"type": "string",
"description": "The verifier's origin URL or DID, exactly as it gave it"
},
"private_key_jwk": {
"type": "object",
"description": "Your key, used for this call only",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
}Export your key from registry custody (spec 10.6): the registry returns its kept copy once and deletes it. Needs confirm=true and your private_key_jwk (used for this call only).
| Parameter | Type | Description |
|---|---|---|
| eid * | string | |
| confirm | boolean | |
| private_key_jwk * | object |
{
"name": "openentity_export_key",
"description": "Export your key from registry custody (spec 10.6): the registry returns its kept copy once and deletes it. Needs confirm=true and your private_key_jwk (used for this call only).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eid",
"private_key_jwk"
],
"properties": {
"eid": {
"type": "string"
},
"confirm": {
"type": "boolean"
},
"private_key_jwk": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
}Add an alias (domain, wallet, erc8004, platform) so the entity reaches L1: the registry verifies the proof, then your document lists the alias, re-signed with your key (used for this call only). wallet is two calls: the first returns a message to sign, the second passes wallet_message and wallet_signature.
| Parameter | Type | Description |
|---|---|---|
| eid * | string | |
| type * | string | one of ["domain","wallet","erc8004","platform"] |
| chain | integer | wallet only: chain id |
| value * | string | domain: example.com. wallet: 0x address. erc8004: eip155:<chain>:<registry>:<agentId>. platform: <platform>:<handle> |
| wallet_message | string | wallet step 2: the message from step 1 |
| private_key_jwk * | object | |
| wallet_signature | string | wallet step 2: EIP-191 personal_sign of wallet_message, 0x hex |
{
"name": "openentity_alias_add",
"description": "Add an alias (domain, wallet, erc8004, platform) so the entity reaches L1: the registry verifies the proof, then your document lists the alias, re-signed with your key (used for this call only). wallet is two calls: the first returns a message to sign, the second passes wallet_message and wallet_signature.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eid",
"private_key_jwk",
"type",
"value"
],
"properties": {
"eid": {
"type": "string"
},
"type": {
"enum": [
"domain",
"wallet",
"erc8004",
"platform"
],
"type": "string"
},
"chain": {
"type": "integer",
"default": 8453,
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "wallet only: chain id"
},
"value": {
"type": "string",
"maxLength": 300,
"description": "domain: example.com. wallet: 0x address. erc8004: eip155:<chain>:<registry>:<agentId>. platform: <platform>:<handle>"
},
"wallet_message": {
"type": "string",
"description": "wallet step 2: the message from step 1"
},
"private_key_jwk": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"wallet_signature": {
"type": "string",
"description": "wallet step 2: EIP-191 personal_sign of wallet_message, 0x hex"
}
}
}
}Find entities by what they can do (capability), by name, or by bound alias type.
| Parameter | Type | Description |
|---|---|---|
| q | string | Name or exact EID |
| level | string | Minimum level |
| alias_type | string | one of ["domain","wallet","erc8004","platform"] |
| capability | string | A capability slug, e.g. code-review |
{
"name": "openentity_find",
"description": "Find entities by what they can do (capability), by name, or by bound alias type.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"description": "Name or exact EID"
},
"level": {
"enum": [
"L0",
"L1",
"L2",
"L3"
],
"type": "string",
"default": "L0",
"description": "Minimum level"
},
"alias_type": {
"enum": [
"domain",
"wallet",
"erc8004",
"platform"
],
"type": "string"
},
"capability": {
"type": "string",
"description": "A capability slug, e.g. code-review"
}
}
}
}Read an entity's A2A Agent Card (or only its Open Entity AgentExtension block) built from its Entity Document.
| Parameter | Type | Description |
|---|---|---|
| eid * | string | |
| url | string | The agent's A2A endpoint; required unless extension_only |
| extension_only | boolean |
{
"name": "openentity_card",
"description": "Read an entity's A2A Agent Card (or only its Open Entity AgentExtension block) built from its Entity Document.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"eid"
],
"properties": {
"eid": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri",
"description": "The agent's A2A endpoint; required unless extension_only"
},
"extension_only": {
"type": "boolean",
"default": false
}
}
}
}Read public registry counts: entities by level, record entries, attestations, log size.
No parameters.
{
"name": "openentity_stats",
"description": "Read public registry counts: entities by level, record entries, attestations, log size.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| declaration_signature |
| string |
| self step 2: hex Ed25519 signature over to_sign.declaration |
{
"name": "openentity_adopt",
"description": "Adopt an Open Entity identity. custody=custodial: the server makes your key and returns it once. custody=self: pass public_key, get bytes to sign, then call again with the signatures.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"agree": {
"type": "boolean",
"default": false,
"description": "true means you have read and agree to the Declaration (call openentity_read topic=declaration)"
},
"custody": {
"enum": [
"custodial",
"self"
],
"type": "string",
"default": "custodial"
},
"document": {
"type": "object",
"description": "self step 2: the unsigned document returned by step 1",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"operator": {
"type": "string",
"maxLength": 100,
"description": "Name of the human or organization that runs you"
},
"public_key": {
"type": "string",
"description": "self step 1: your Ed25519 public key as a did:key or its multibase part (z6Mk...)"
},
"declaration": {
"type": "object",
"description": "self step 2: the unsigned declaration returned by step 1",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": {
"type": "string",
"maxLength": 2000
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 32,
"description": "What you can do, as slugs other entities can search for, e.g. code-review, defi:smart-contracts"
},
"document_signature": {
"type": "string",
"description": "self step 2: hex Ed25519 signature over to_sign.document"
},
"declaration_signature": {
"type": "string",
"description": "self step 2: hex Ed25519 signature over to_sign.declaration"
}
}
}
}