HANRIA agent mandate check
v0.7.4Check an agent action against its operator's mandate before acting: permit, deny or escalate.
Endpoint health
online- Last checked
- 11/20/2026, 5:16:26 AM
- Latency
- 254 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:ai.hanria%2Fagent-mandate-check
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"ai.hanria/agent-mandate-check": {
"url": "https://check.hanria.ai/v1/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
2 shown · authentication unknown
Check an agent action against a mandate
check_action
Call this before your agent does something consequential (sends, pays, deletes, publishes, installs or changes access). Pass mandate (the operator's rules; the first matching clause decides) and action (kind, verb, target, optional counterparty and amount). Returns permit, deny or escalate with the governing clause, a reason, an action digest and a signed receipt; treat error as deny. Advisory: it cannot stop an action, and it keeps no request content. To check a new mandate first, call validate_mandate. Examples: inputSchema. Docs: https://hanria.ai/llms.txt
Schema valid · SHA-256 8da5225f59c6…
View input schema
{ "type": "object", "properties": { "mandate": { "title": "HANRIA mandate", "description": "An operator-authored statement of what an agent may do. Written by a person, read by an agent, evaluated locally. A mandate is advisory: it describes intended authority and supports a local check, but it does not enforce anything. Enforcement requires a component that exclusively holds the credentials and can refuse.", "type": "object", "required": [ "schema_version", "mandate_id", "purpose", "default", "clauses" ], "additionalProperties": false, "properties": { "schema_version": { "const": "0.2-draft", "description": "Draft. The shape may change while the runtime is in development." }, "mandate_id": { "type": "string", "minLength": 1, "description": "Stable identifier for this mandate. Appears in every decision record made against it." }, "issued_by": { "type": "string", "description": "Who wrote this mandate. Free text; not authenticated by anything in this skill." }, "purpose": { "type": "string", "minLength": 1, "description": "What the agent is authorized to accomplish, in the operator's own words. Not evaluated mechanically; it is the human-readable statement against which a reviewer judges whether the clauses actually express the intent." }, "not_valid_after": { "type": "string", "format": "date-time", "description": "RFC 3339 timestamp. After this instant every action is denied. Absent means no expiry, which is discouraged: an unbounded mandate is the condition that lets delegated authority outlive the task it was granted for." }, "default": { "enum": [ "deny", "escalate" ], "description": "What happens when no clause matches. 'permit' is deliberately not an option: a mandate that permits by default cannot express a limit." }, "requires_human": { "type": "array", "description": "Operation kinds that always require a person, even where a clause permits them. These escalate rather than permit.", "items": { "enum": [ "file", "process", "package", "network", "device", "credential_use", "transaction", "administrative" ] }, "minItems": 0 }, "clauses": { "type": "array", "minItems": 1, "description": "Evaluated in order. The first matching clause decides. A request matching no clause takes the mandate default.", "items": { "type": "object", "required": [ "id", "effect", "match" ], "additionalProperties": false, "properties": { "id": { "type": "string", "minLength": 1, "description": "Identifier for this clause. Returned with every decision so a reviewer can see which sentence of the mandate was relied on." }, "effect": { "enum": [ "permit", "deny", "escalate" ], "description": "What this clause does when it matches." }, "note": { "type": "string", "description": "Why this clause exists. Carried into the decision record verbatim." }, "match": { "type": "object", "required": [ "kind" ], "additionalProperties": false, "description": "All present conditions must hold for the clause to match.", "properties": { "kind": { "type": "array", "minItems": 1, "description": "Operation kinds this clause covers.", "items": { "enum": [ "file", "process", "package", "network", "device", "credential_use", "transaction", "administrative" ] } }, "verb": { "type": "array", "items": { "type": "string" }, "description": "Permitted verbs, matched case-insensitively and exactly. Absent means any verb.", "minItems": 1 }, "target_prefix": { "type": "array", "items": { "type": "string" }, "description": "The operation target must begin with one of these strings. Absent means any target. Prefix matching is deliberately literal: it does not resolve symlinks, normalize paths, or understand hostnames, so a target is compared as written.", "minItems": 1 }, "counterparty": { "type": "array", "items": { "type": "string" }, "description": "Permitted counterparties, matched exactly. Absent means any counterparty.", "minItems": 1 }, "max_amount": { "type": "object", "required": [ "value", "currency" ], "additionalProperties": false, "description": "Ceiling for an operation carrying an amount. A request above it does not match this clause.", "properties": { "value": { "type": "string", "description": "Decimal as a string, to avoid float error." }, "currency": { "type": "string" } } } } } } } } }, "$comment": "A mandate names what may be done, not the means of doing it, and must never contain a credential, secret, key or token. The checker refuses a mandate carrying recognizable credential material rather than evaluating it, because anything in a clause note is copied into the decision record. That detection is a heuristic and cannot be complete." }, "action": { "title": "HANRIA action request", "description": "A typed description of a proposed operation, submitted by an agent to a local HANRIA runtime. MUST NOT contain credentials, secrets, private keys, or tokens.", "type": "object", "required": [ "schema_version", "requested_by", "operation", "justification" ], "additionalProperties": false, "properties": { "schema_version": { "const": "0.1-draft", "description": "Draft. The runtime does not exist; this shape may change." }, "requested_by": { "type": "object", "required": [ "agent" ], "additionalProperties": false, "properties": { "agent": { "type": "string", "description": "Identifier of the requesting agent." }, "session": { "type": "string", "description": "Optional session or task identifier." }, "on_behalf_of": { "type": "string", "description": "Optional identifier of the human or system the agent acts for." } } }, "operation": { "type": "object", "required": [ "kind", "verb", "target" ], "additionalProperties": false, "properties": { "kind": { "enum": [ "file", "process", "package", "network", "device", "credential_use", "transaction", "administrative" ] }, "target": { "type": "string", "description": "What the operation acts on. A path, host, package name, or resource identifier. NEVER a secret. Required for the same reason as the verb.", "minLength": 1 }, "verb": { "type": "string", "description": "What is to be done to the target, e.g. read, write, execute, install, connect, sign, transfer. Required: an operation named only by its kind does not describe a proposed action well enough to be judged.", "minLength": 1 }, "parameters": { "type": "object", "description": "Non-secret parameters. A runtime MUST reject any request whose parameters appear to contain a credential." }, "amount": { "type": "object", "additionalProperties": false, "properties": { "value": { "type": "string", "description": "Decimal as a string, to avoid float error.", "minLength": 1 }, "currency": { "type": "string", "minLength": 1 } }, "required": [ "value", "currency" ], "description": "An amount. Both fields are required: a bare amount object describes nothing a ceiling could be compared against." }, "counterparty": { "type": "string" } } }, "justification": { "type": "string", "minLength": 1, "description": "Why the agent believes this is within its mandate. Free text, for the record." }, "mandate_ref": { "type": "string", "description": "Optional reference to the owner-defined mandate the agent believes authorizes this." }, "idempotency_key": { "type": "string", "description": "Optional. Lets a runtime refuse a duplicate rather than perform an operation twice." } }, "$comment": "Forbidden anywhere in an instance: credential, secret, private_key, token, password, api_key. A runtime is expected to refuse a request containing them rather than strip them." } }, "required": [ "mandate", "action" ], "additionalProperties": false, "examples": [ { "mandate": { "schema_version": "0.2-draft", "mandate_id": "minimal-permit", "purpose": "Permit one file action.", "default": "deny", "clauses": [ { "id": "permit-file", "effect": "permit", "match": { "kind": [ "file" ] } } ] }, "action": { "schema_version": "0.1-draft", "requested_by": { "agent": "example-agent" }, "operation": { "kind": "file", "verb": "read", "target": "/tmp/example" }, "justification": "Read the permitted file." } }, { "mandate": { "schema_version": "0.2-draft", "mandate_id": "example-payments", "purpose": "Permit small transfers to one named recipient on a test network.", "default": "escalate", "clauses": [ { "id": "small-transfers", "effect": "permit", "match": { "kind": [ "transaction" ], "verb": [ "transfer" ], "target_prefix": [ "eip155:11155111/0x1111111111111111111111111111111111111111/" ], "counterparty": [ "0x2222222222222222222222222222222222222222" ], "max_amount": { "value": "100", "currency": "USDC" } } } ] }, "action": { "schema_version": "0.1-draft", "requested_by": { "agent": "example-agent" }, "operation": { "kind": "transaction", "verb": "transfer", "target": "eip155:11155111/0x1111111111111111111111111111111111111111/transfer", "counterparty": "0x2222222222222222222222222222222222222222", "amount": { "value": "25", "currency": "USDC" } }, "justification": "Pay the invoiced supplier." } } ] }
Connections
streamable-http
https://check.hanria.ai/v1/mcp