Servidor MCP

Kevros — Agentic Identity Trust

io.github.ndl-systems/kevros
Seguridad Público y accesible MCP 2025-11-25

Qué hace este MCP

Verifies agent actions against policies and creates cryptographic attestations, provenance chains, intent bindings, release tokens, and compliance evidence.

attest
Attest Action
Create a hash-chained provenance record for an action you've taken. Each attestation extends the append-only evidence chain. The hash can be independently verified by any third party. Cost: $0.02 per call.
Esquema de entrada
{'type': 'object', 'required': ['agent_id', 'action_description', 'action_payload'], 'properties': {'context': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Optional metadata such as environment, trigger, or session info'}, 'agent_id': {'type': 'string', 'description': 'Unique identifier of the attesting agent'}, 'action_payload': {'type': 'object', 'description': 'Structured data describing the action (hashed into provenance)', 'additionalProperties': True}, 'action_description': {'type': 'string', 'description': 'Human-readable description of the action taken'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
bind
Bind Intent to Command
Declare an intent and cryptographically bind it to a command. Proves that the command was issued in service of the declared intent. Use verify-outcome after execution to close the loop. Cost: $0.02 per call.
Esquema de entrada
{'type': 'object', 'required': ['agent_id', 'intent_type', 'intent_description', 'command_payload'], 'properties': {'agent_id': {'type': 'string', 'description': 'Unique identifier of the agent declaring intent'}, 'goal_state': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Expected end state for outcome verification'}, 'intent_type': {'type': 'string', 'description': "Category of intent (e.g. 'navigation', 'transaction', 'deployment')"}, 'intent_source': {'type': 'string', 'default': 'AI_PLANNER', 'description': 'Origin of intent: AI_PLANNER, HUMAN_OPERATOR, or SYSTEM'}, 'command_payload': {'type': 'object', 'description': 'The command that will be executed to fulfill this intent', 'additionalProperties': True}, 'parent_intent_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'ID of parent intent for hierarchical intent chains'}, 'intent_description': {'type': 'string', 'description': 'Human-readable description of what the agent intends to do'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
bundle
Generate Compliance Bundle
Generate a certifier-grade compliance evidence bundle. Contains hash-chained provenance, intent bindings, PQC attestations, and verification instructions. Independently verifiable without Kevros access. Cost: $0.05 per call.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['agent_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Agent whose provenance records to include in the bundle'}, 'max_records': {'type': 'integer', 'default': 10000, 'description': 'Maximum number of provenance records to include'}, 'time_range_end': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'ISO 8601 end time filter (inclusive)'}, 'time_range_start': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'ISO 8601 start time filter (inclusive)'}, 'include_intent_chains': {'type': 'boolean', 'default': True, 'description': 'Include intent-command binding chains in the bundle'}, 'include_pqc_signatures': {'type': 'boolean', 'default': True, 'description': 'Include post-quantum ML-DSA-87 block signatures'}, 'include_verification_instructions': {'type': 'boolean', 'default': True, 'description': 'Include step-by-step verification procedure for auditors'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
check-peer
Check Peer Trust
Check another agent's trust score and governance history. Returns trust score (0-100), chain length, attestation count, and tier. Free, no API key needed.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['agent_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'ID of the peer agent to look up'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
health
Health Check
Check the governance gateway health status. Free.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'verbose': {'type': 'boolean', 'default': False, 'description': 'Return additional details such as chain length and PQC signing status'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
status
Trust Status
Check your current usage and quota: calls used, calls remaining, tier, rate limits, and billing status. Free.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'include_chain_details': {'type': 'boolean', 'default': False, 'description': 'Include hash-chain integrity check and latest provenance epoch'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
verify
Verify Action
Verify an action against policy bounds before executing it. Returns ALLOW (proceed), CONSTRAIN (proceed with modified values; emitted on the wire as the legacy value CLAMP - both refer to the same verdict, CONSTRAIN is the public name), or DENY (stop). Every verification is recorded in a hash-chained provenance ledger. Cost: $0.01 per call.
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['action_type', 'action_payload', 'agent_id'], 'properties': {'agent_id': {'type': 'string', 'description': 'Unique identifier of the agent requesting verification'}, 'action_type': {'type': 'string', 'description': "Category of action to verify (e.g. 'deploy', 'trade', 'send_email')"}, 'template_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': "Named policy template (e.g. 'robotics-arm', 'financial-transaction'). Merged with policy_context."}, 'action_payload': {'type': 'object', 'description': 'Action parameters to verify against policy bounds', 'additionalProperties': True}, 'policy_context': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'default': None, 'description': 'Optional policy overrides such as max_values or forbidden_keys'}, 'idempotency_key': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional key for idempotent retries  -  same key returns cached result'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
verify-outcome
Verify Outcome
Verify that an executed action achieved its declared intent. Closes the loop: intent -> command -> action -> outcome -> verification. Free (included with bind).
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['agent_id', 'intent_id', 'binding_id', 'actual_state'], 'properties': {'agent_id': {'type': 'string', 'description': 'Unique identifier of the agent whose outcome is being verified'}, 'intent_id': {'type': 'string', 'description': 'ID of the original intent from governance_bind'}, 'tolerance': {'type': 'number', 'default': 0.1, 'description': 'Numeric tolerance for goal matching (0.1 = 10% deviation allowed)'}, 'binding_id': {'type': 'string', 'description': 'ID of the intent-command binding from governance_bind'}, 'actual_state': {'type': 'object', 'description': 'Observed end state after action execution, compared against goal_state', 'additionalProperties': True}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
verify-token
Verify Release Token
Verify a release token from another agent. Confirms the token is authentic, was issued by the Kevros gateway, and remains currently authorized after any halt or mode transition. Free, no API key needed.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['release_token'], 'properties': {'release_token': {'type': 'string', 'description': 'Release token string received from governance_verify'}, 'token_preimage': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Deprecated. The gateway now performs verification entirely server-side using the release_token alone; any value supplied here is ignored. Field retained for backward compatibility with v1 SDK callers and will be removed in a future release.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'string'}}, 'x-fastmcp-wrap-result': True}
Añadido
verify-token
19 de September de 2026 a las 02:44
Añadido
check-peer
19 de September de 2026 a las 02:44
Añadido
status
19 de September de 2026 a las 02:44
Añadido
health
19 de September de 2026 a las 02:44
Añadido
bundle
19 de September de 2026 a las 02:44
Añadido
verify-outcome
19 de September de 2026 a las 02:44
Añadido
bind
19 de September de 2026 a las 02:44
Añadido
attest
19 de September de 2026 a las 02:44
Añadido
verify
19 de September de 2026 a las 02:44