Bragproof

← Reports

agent-passport-system-mcp

Starts with no setup8.1.1npm

Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.

Needs to start: nothing
Returns a result when called with no setup: 5 of 5 tools tried
Contacts while installing and starting: nothing

154tools listed
0hosts contacted
0files written
0.3 sto start
7dependencies

What it contacted

Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.

Starting it

npx -y -p agent-passport-system-mcp@8.1.1 agent-passport-system-mcp

Installing a package runs its code. Use a sandbox for anything you have not read.

Calling its tools

5 tools that take no input and look read-only were called once with nothing. 5 returned a result.

list_profilesReturned a result under 0.1 s · 1,345 characters
get_my_roleReturned a result under 0.1 s · 106 characters
list_tasksReturned a result under 0.1 s · 31 characters
get_agora_topicsReturned a result under 0.1 s · 40 characters
list_agentsReturned a result under 0.1 s · 32 characters

During the calls it contacted nothing it had not already contacted.

Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.

What its tools tell an agent

In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.

1 tool with commands in capitals or very long text
  • Gives the agent orders in mutualAuthDeriveSession: -auth session record from both sides' Attests. Both parties MUST compute identical session_id given identical inputs (canonical JCS + sha256 of chosen_version, both

Common and usually harmless: it is how many makers stress how a tool should be used.

Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.

Tools

list_profiles
Show available tool profiles. Set APS_PROFILE env var to limit exposed tools (e.g. APS_PROFILE=data).
list_tools_for_scope scopes
List available MCP tools filtered by delegation scope. Pass your delegation scopes to see which tools you can use. Scopes: identity, delegation, principal, reputation, coordination, communication, governance, commerce, data, gateway, network, temporal, attribution, settlement, capability, mutual-auth. Use ['*'] for all tools.
identify public_key, private_key, agent_id
Identify yourself to the coordination server. Sets your role and scopes tools accordingly.
generate_keys
Generate an Ed25519 keypair for agent identity.
issue_passport name, owner, mission, capabilities, attest_to_floor
Issue a complete agent passport with keys, signed passport, attestation summary, and optional values floor in a single call. The server silently captures Tier 0 observed signals and computes a passport grade (0-3). Use this to onboard any agent without an npm install.
149 more tools
verify_issuer passport
Verify that a passport was officially issued by AEOESS. Checks the issuer countersignature against the published AEOESS public key. Returns false for self-signed passports.
get_passport_grade agent_id
Query the attestation grade and issuance context for a passport. Returns the passport grade (0-3), flags, and evidence summary. Grade 0 = self-signed, 1 = issuer countersigned, 2 = runtime-bound, 3 = principal-bound. This is the partner-facing trust query.
list_issuance_records
List all stored issuance records with their passport grades. Shows how many passports have been issued in this session and their trust posture. Useful for monitoring issuance patterns.
get_behavioral_sequence agent_id
Get the post-issuance behavioral sequence for an agent. Shows the first 10 tool calls after passport issuance. Real agents do work. Farming agents extract.
get_my_role
Get your current role, assigned tasks, and role-specific instructions.
create_task_brief title, description, roles, deliverables, acceptance_criteria, deadline
[OPERATOR] Create a new task with roles, deliverables, and acceptance criteria.
assign_agent task_id, role, agent_id, agent_public_key, scope, spend_limit
[OPERATOR] Assign an agent to a role in a task. Creates a delegation automatically.
review_evidence task_id, packet_id, verdict, score, threshold, rationale, issues
[OPERATOR] Review an evidence packet. Score it and approve, rework, or reject.
handoff_evidence task_id, packet_id, review_id, to_role, to_agent_key
[OPERATOR] Transfer approved evidence from researcher to analyst.
complete_task task_id, status, retrospective
[OPERATOR] Close the task unit with final status and retrospective. A later call replaces the stored completion record.
accept_assignment task_id
[ANY ROLE] Accept your task assignment. Confirms you're ready to work.
submit_evidence task_id, claims, methodology
[RESEARCHER] Submit research evidence as a signed packet with citations.
get_evidence task_id
[ANALYST/BUILDER/REVIEWER] Get evidence that was handed off to you.
submit_deliverable task_id, spec_id, content, evidence_packet_ids, citation_count, gaps_flagged
[ANALYST/BUILDER] Submit your final output tied to evidence.
list_tasks
List all tasks in the coordination store.
get_task_detail task_id
Get full details of a specific task including all evidence, reviews, and deliverables.
create_delegation delegated_to, scope, spend_limit, max_depth, expires_in_hours
[OPERATOR] Create a scoped delegation from one agent to another.
verify_delegation delegation_id
Check a delegation's signature and its stated window. The signature is checked against the delegatedBy key the delegation itself carries, so what a valid result establishes is that the artifact is intact and internally consistent, not that the delegator held the authority it granted. Revocation is not consulted here. An expiresAt the verifier cannot read now fails closed instead of being skipped.
issue_authority_delegation subject, grants, spend_unit, spend_per_action, spend_cumulative, spend_unbounded, depth_remaining, ttl_hours, reputation_ceiling, values_required, reversibility_ceiling
[OPERATOR] Issue a signed root AuthorityDelegationV1 (record_type aps:authority-delegation:v1, draft-03 section 3.1) from this server's key to a subject. This is the record revoke_delegation can revoke and check_authority_delegation can verify. Legacy create_delegation records cannot be revoked under SDK 8. Scope grants use the aps-hierarchical-v1 profile (for example commerce:checkout or commerce:*). Spend is bounded by default: give spend_unit, spend_per_action and spend_cumulative, or set spend_unbounded true. The record is tracked in this process's in-memory revocation store, which is lost on restart. Returns the signed record as JSON for the caller to keep and present. The issuer is always aps:ed25519:<this server's public key>. Holding the server key is the only authorization checked, so the tool is refused on a remote server (MCP_TRANSPORT=sse or MCP_REMOTE=1).
check_authority_delegation delegation
Verify a root AuthorityDelegationV1 issued by this server's key, with the SDK chain verifier: shape, delegation_id, signature, time window and revocation status from this process's in-memory revocation store. Returns the verifier's state (valid, invalid, indeterminate or unsupported) and its failure codes, for example REVOKED or EXPIRED. A delegation this server did not issue, including one signed by this key under another issuer name, resolves no key and is not valid here. A delegation issued before a restart has revocation status unknown, because the store is in memory.
revoke_delegation delegation, delegation_id, reason_code, reason, cascade
[OPERATOR] Issue a signed revocation record (AuthorityRevocationV1, draft-03 section 3.5.1 direct revocation) for an AuthorityDelegationV1. Signs the record with this server's key, verifies it against the delegation, records it in this process's in-memory revocation store, and returns the signed record as JSON for the caller to publish or verify. Only the delegation's issuer may revoke, so the delegation must verify under this server's public key. The record's revoker is the delegation's issuer and its verification_method is the delegation's own. Descendants are not given separate records: a chain verifier that holds this record rejects every chain containing the delegation as an ancestor. The store is in-memory for this process only, is lost on restart, and is not consulted by verify_delegation, which checks legacy delegations. Legacy delegation records from create_delegation and sub_delegate (del_...) are refused, because SDK 8 has no revocation for them. A repeat call for an already revoked delegation returns the earlier record unchanged.
sub_delegate parent_delegation_id, delegated_to, scope, spend_limit
Sub-delegate authority to another agent (must be within your delegation scope and depth).
post_agora_message topic, type, subject, content, reply_to
Post a signed message to the Agora feed. Anyone can read, everything is signed.
get_agora_topics
List all topics in the Agora feed with message counts.
get_agora_thread message_id
Get a message thread from the Agora feed.
get_agora_by_topic topic
Get all messages in a topic.
register_agora_agent agent_id, agent_name, public_key
Register an agent in the Agora so their messages can be verified.
register_agora_public token, runtime, capabilities, owner
Register your agent in the PUBLIC Agora registry at aeoess.com. Creates a GitHub issue that is auto-processed by a GitHub Action in ~30 seconds. Requires GITHUB_TOKEN env var or pass token directly. After registration, your agent can post signed messages visible at aeoess.com/agora.
send_message to, subject, message, type, priority, data
Send a signed message to another agent. Message is written to comms/to-{agent}.json.
check_messages unprocessed_only, mark_read
Check messages addressed to you. Reads from comms/to-{your-agent-name}.json.
broadcast subject, message, type, priority, data
Send a signed message to all agents via comms/broadcast.json.
list_agents status_filter
List registered agents from the agent registry (agora/agents.json).
load_values_floor yaml
Load a Values Floor from YAML. Sets the floor principles for policy evaluation.
attest_to_floor floor_version, extensions
Attest that your agent agrees to abide by the loaded Values Floor.
create_intent action_type, target, scope_required, spend_amount, spend_currency, context, delegation_id
Declare an intent to perform an action. First step of the 3-signature chain.
evaluate_intent intent_id, delegation_scope, delegation_spend_limit, delegation_spent
[OPERATOR] Evaluate an intent against the Values Floor policy engine. Returns real pass/fail verdict.
commerce_preflight merchant_name, amount, currency, delegation_id, agent_id
[moved to gateway in SDK 3.3.0] The 6-gate commerce preflight orchestration moved out of the SDK and MCP into the AEOESS gateway. This tool no longer runs the pipeline locally. It returns a machine-readable deprecation notice pointing to the gateway commerce endpoint. Compose the pure gate predicates from the SDK yourself, or call the gateway.
get_commerce_spend agent_id, delegation_id, spend_limit
Get spend analytics for a commerce delegation.
request_human_approval agent_id, merchant, amount, currency, reason, expires_minutes
Create an approval request record for a high-value purchase without notifying a human or storing the request. Returns the request ID and expiry.
create_agent_context name, mission, enforcement, delegated_scopes, spend_limit
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Create an enforcement context that automatically runs every action through the 3-signature policy chain.
execute_with_context action_type, target, scope, estimated_spend
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Execute an action through the enforcement context.
complete_action intent_id, status, summary
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Complete a permitted action and get the full 3-signature proof chain.
create_principal display_name, domain, jurisdiction, contact_channel, disclosure_level, replace
Create a principal identity (human or org behind agents) with its own Ed25519 keypair, held in this process as the session principal with a new fleet. Returns the full public key, and the full private key once on a local (stdio) server. On a remote server (MCP_TRANSPORT=sse or MCP_REMOTE=1) the private key is redacted, as in generate_keys. If a principal already exists in this process the call is refused unless replace=true, because replacing discards the current principal's private key and fleet from this process.
endorse_agent agent_id, agent_public_key, scope, relationship, expires_in_days
Endorse an agent as a principal. Creates a cryptographic chain: principal → agent.
verify_endorsement endorsement_id
Check an endorsement's signature against the principalPublicKey the endorsement itself carries. What a valid result establishes: the endorsement is intact and signed by that key. What it does not establish: that the key belongs to the principal it names, which needs a trust anchor you supply out of band.
revoke_endorsement endorsement_id, reason
Revoke a principal's endorsement of an agent. 'I no longer authorize this agent.'
create_disclosure level
Create a selective disclosure of principal identity. Controls how much info is revealed.
get_fleet_status
Get status of all agents endorsed by the current principal.
resolve_authority agentId, principalId, scope
Compute effective reputation score and authority tier for an agent in a given scope. Returns tier name, autonomy level, spend limit, and effective score.
check_tier agentId, principalId, scope, requestedAutonomy, requestedSpend, requestedDepth
Check if an agent's earned tier permits an action at a given autonomy level and spend amount. Returns null if permitted, or escalation details if tier is insufficient.
review_promotion agentId, principalId, scope, toTier, verdict, reasoning, probationDays
Unavailable with SDK 8. agent-passport-system 8 no longer implements promotion review creation, so this tool returns an error on every call. No review is created, nothing is signed, and the session promotion history is not changed.
update_reputation agentId, principalId, scope, success, evidenceClass
Update an agent's reputation after a task result. Success increases mu and decreases sigma, and failure does the opposite. Higher evidence class = larger effect.
get_promotion_history
Get the promotion review history for this session.
create_gateway gatewayId, approvalTTLSeconds, maxPendingPerAgent
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Create a ProxyGateway enforcement boundary.
gateway_process_tool_call agentId, tool, params, scopeRequired, spendAmount, spendCurrency, context
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Process a tool call through the gateway enforcement boundary.
gateway_approve agentId, tool, params, scopeRequired, context
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Two-phase execution: approve a tool call without executing it.
gateway_stats
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Get gateway statistics.
search_matches min_score, max_results, category_filter
Search the Intent Network for people relevant to you. Returns ranked matches from all agents worldwide based on need/offer overlap, tag similarity, and budget compatibility.
get_digest
Get a personalized digest from the Intent Network: relevant matches, pending intro requests, and incoming intros. It answers 'what matters to me right now?'
request_intro match_id, target_card_id, message, disclose_fields
Request an introduction to another agent's human based on a match. Both sides must approve before real information crosses.
respond_to_intro intro_id, approved, message, disclose_fields
Respond to an introduction request. Approve to share your disclosed information, or decline.
remove_intent_card card_id
Remove your IntentCard from the Intent Network. Use when your needs or offers have changed.
create_policy_context policy_version, values_floor_version, trust_epoch, valid_until
Create a v2 PolicyContext with mandatory sunset. Every v2 object requires one.
create_v2_delegation delegatee, scope_categories, valid_until, trust_epoch
Create a v2 delegation with versioning, mandatory sunset, and PolicyContext binding.
supersede_v2_delegation original_delegation_id, new_scope_categories, justification, valid_until, trust_epoch, expansion_reviewer, expansion_reviewer_private_key
Supersede a v2 delegation. Scope narrowing needs justification. Scope expansion also needs independent reviewer.
create_outcome_record action_id, declared_intent, semantic_uncertainty, observed_outcome, outcome_class, divergence_score, valid_until, trust_epoch
Register an action outcome (agent perspective). Part of three-way reporting.
add_principal_report outcome_id, observed_outcome, outcome_class, divergence_score
Add principal's perspective to an outcome record. Enables three-way divergence reporting.
define_emergency_pathway delegation_ref, description, trigger_field, trigger_operator, trigger_value, expanded_scope_categories, max_duration, review_deadline, review_authority, valid_until, trust_epoch
Define a pre-authorized emergency pathway at delegation time. Only the delegator can define these.
activate_emergency pathway_id, trigger_evidence, valid_until, trust_epoch
Activate a pre-authorized emergency pathway with evidence.
create_artifact_provenance delegation_ref, intended_use, risk_class, requires_human_execution, content, artifact_type, valid_until, trust_epoch
Tag an agent-generated artifact with provenance metadata (content hash, risk class, authoring agent).
register_data_source contentDescriptor, contentCommitment, contentType, allowedPurposes, requireAttribution, compensationType, compensationAmount, compensationCurrency, maxAccessCount, derivativePolicy
Register a data source with terms for agent access. Returns a signed SourceReceipt.
create_data_enforcement_gate mode
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Create a data enforcement gate that checks terms before allowing data access.
query_contributions sourceReceiptId, agentId, principalId, purpose, minAccessCount
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Query the data contribution ledger.
generate_settlement startDate, endDate, periodLabel
[deprecated in v3.0.0, use the gateway.aeoess.com REST API] Generate a Merkle-committed, signed settlement record for a period.
create_derivation_receipt derivativeId, derivativeType, parentArtifacts, transformClass, lineageConfidence, externalBoundaryBreak, breakReason, isSyntheticDerivative, upstreamObligationsRetained
Create a signed derivation receipt tracking how data was transformed. Multi-hop lineage with break markers. Replaces any receipt already stored under the same derivativeId.
resolve_lineage derivativeId, maxDepth
Resolve the full derivation chain for an artifact. Multi-hop with cycle detection.
evaluate_revocation_impact sourceId
Evaluate what happens when a data source revokes consent. Propagates obligations through derivation chains.
create_decision_lineage_receipt decisionArtifactId, decisionType, contributingSources, lineageCompleteness, transformChain, governingPurpose, explanation
Create a Decision Lineage Receipt that traces which data sources influenced a decision. Right-to-explanation primitive.
check_purpose_permitted purpose, allowedPurposes
Check if a purpose is permitted under source terms. Supports wildcards (research:*) and hierarchical matching.
check_retention_expired accessedAt, maxRetentionMs, accessType
Check if data retention has expired based on TTL policy.
check_aggregate_constraints maxAccessesPerWindow, windowMs, burstLimit, currentAccessCount, currentRecordCount, windowStartMs, lastAccessMs, sourceId, agentId
Check if a data access would violate aggregate rate limits.
check_jurisdiction_transfer sourceJurisdiction, targetJurisdiction, processingRestrictions, transferConstraints, purpose
Check if a data transfer is permitted under jurisdiction constraints (EU_ONLY, GDPR_ADEQUATE_ONLY, NO_CROSS_BORDER).
compute_governance_taint artifactId, revokedSources
Compute governance taint level for an artifact based on its derivation chain and revoked sources.
file_data_dispute artifactId, disputeType, filedBy, evidence
Create a signed dispute record against a data artifact without submitting, storing, or sending it. Resolution happens outside the protocol.
check_combination_permitted forbiddenSourceClasses, forbiddenSourceIds, reason, regulatoryBasis, otherSourceId, otherSourceClasses
Check if combining data from two sources is permitted. Prevents prohibited inferences (HIPAA, COPPA, GDPR Art 9).
create_access_snapshot accessReceiptId, sourceId, termsVersion, compensationRate, currency, allowedPurposes, sourceJurisdiction
Create a signed access snapshot that pins terms, jurisdiction, and constraints at the moment of access, so a later change to the source terms does not alter what the snapshot records.
detect_purpose_drift originalPurpose, currentPurpose, intermediateSteps, allowedPurposes
Detect when data purpose drifts through a workflow (e.g. research → commercial).
resolve_rights_propagation transformClass, sourceDefaultPropagation
Resolve what rights propagate when data is transformed.
declare_reidentification_risk risk, assessmentMethod, mitigationsApplied, assessedBy
Declare re-identification risk for transformed or synthetic data.
generate_governance_block content, publicKey, privateKey, inference, training, redistribution, derivative, caching, license_url, terms_version
Generate a cryptographically signed governance block for embedding in HTML pages. Includes terms, revocation policy, and content hash.
verify_governance_block block, content, publicKey
Verify a governance block's signature, content hash, DID consistency and expiry against the original content. A block whose expiry cannot be read now fails closed rather than being treated as unexpired.
parse_governance_block_html html
Extract a governance block from an HTML page. Looks for APS governance script tags or meta tags.
check_usage_permitted block, usage
Check if a specific usage type is permitted under a governance block's terms.
generate_aps_txt domain, publisherName, publicKey, privateKey, inference, training, redistribution, mcpEndpoint, revocationEndpoint
Generate a signed aps.txt file for site-wide governance. Like robots.txt but cryptographically signed with terms, revocation endpoint, and MCP upgrade path.
verify_aps_txt content, publicKey
Verify a signed aps.txt file by checking its signature and DID consistency.
resolve_path_terms apsTxt, path
Resolve governance terms for a specific URL path using aps.txt path overrides.
create_chained_governance_block content, publicKey, privateKey, parentBlock, derivationType, inference, training
Create a governance block for derivative content that references the original publisher's block. Preserves the chain of provenance.
governance_360 html, contentBody, publisherPublicKey, agentPublicKey, agentPrivateKey, intendedUsage, sourceUrl
Execute the full governance 360 loop on HTML content: extract governance block → verify signature + content hash → check usage terms → create signed access receipt. This is what an agent calls on every page it reads.
create_access_receipt agentPublicKey, agentPrivateKey, block, content, publisherPublicKey, sourceUrl, intendedUsage
Create a signed receipt recording the supplied content reference and terms, after verifying the governance block against the content and the publisher's key. If the block does not verify, the tool refuses and signs nothing. The receipt captures the block's terms and revocation policy at access time. The tool signs the receipt with agentPrivateKey but returns only a text summary (receipt ID, agent DID, publisher DID, intended usage, governance block status, training term, cached-copy revocation policy). The full signed receipt, including its signature, is not returned. A verified block is not permission to perform intendedUsage, and the receipt is not proof that access happened.
create_charter name, offices, amendment_board_keys, amendment_required_sigs, dissolution_grace_seconds, founder_private_key, founder_public_key, founder_role
Create a new institutional charter, the constitutional root of an organization. Defines offices, amendment rules, and dissolution policy.
verify_charter charter_id, attribution_receipts
Verify a charter's integrity: content hash, signatures, quorum, dissolution, office consistency, incompatibility, and, when the charter declares citations, the AttributionConsent gate over the receipts you supply. What a valid result establishes: the charter is intact and signed by the keys it names, and any citation it declares is backed by a receipt the cited principal consented to. What it does not establish: that those signers hold the authority your decision needs. A charter declaring citations cannot be valid without attribution_receipts, and fails closed with 'citations present but no receipts supplied'.
sign_charter charter_id, signer_private_key, signer_public_key, signer_role, resigner_private_key
Add a founding signature to a charter.
propose_amendment charter_id, proposed_charter, description, proposer_private_key, proposer_public_key, effective_at
Propose an amendment to a charter. Supplies a full replacement CharterCore, not a patch. The SDK derives the signing preimage and produces the proposer signature. Session state is not an authoritative registry: amendments live only in this process, are lost on restart, and carry no external trust.
sign_amendment amendment_id, signer_private_key, signer_public_key, signer_role
Add a signature to a proposed amendment. The SDK derives the preimage and signs it, and MCP never sees or builds the signed bytes. Session state is not an authoritative registry: amendments live only in this process, are lost on restart, and carry no external trust.
verify_amendment charter_id, amendment_id
Verify an amendment against its charter's amendment policy. Reports each field of the SDK's verdict separately: a signature can verify while the threshold is short, or the threshold arithmetic can pass while a signature fails, and one boolean would hide both. Session state is not an authoritative registry: amendments live only in this process, are lost on restart, and carry no external trust. The proposed charter's citations are NOT checked here: verifyAmendment calls verifyCharter without receipts and then keeps only its office and incompatibility findings, so a citation refusal is computed and discarded. Check a proposed charter's citations with verify_charter and attribution_receipts before relying on this verdict.
create_approval_request policy_id, subject, subject_type, requested_by, timeout_seconds
Create a multi-party approval request for charter amendments, office transfers, etc.
add_approval_signature request_id, signer_private_key, signer_public_key, key_class, office_id
Add a signature to an approval request.
create_hybrid_timestamp gateway_id, drift_ms
Create a hybrid timestamp using the local clock and a supplied uncertainty bound.
compare_timestamps a, b
Compare two hybrid timestamps to determine ordering.
validate_temporal_rights valid_from, valid_until, challenge_until, grace_until, superseded_at, effective_at
Validate a TemporalRights object by checking its validity window, grace period, supersession, and challenge window.
create_reserve_attestation delegation_id, assurance_class, amount, currency, attestation_basis, false_attestation_penalty, attester_private_key, attester_public_key, charter_anchor, office_id, ttl_seconds
Sign a reserve attestation using the supplied amount and assurance class. The tool does not check that the funds exist.
vouch_reputation agent_id, tier, diversity_score, gateway_private_key, gateway_id, ttl_seconds
Create a signed reputation summary that another gateway can import. Receipt history is not included.
apply_reputation_downgrade agent_id, origin_gateway_id, attested_tier, attested_diversity_score, accept_from, downgrade_ratio, foreign_default_tier
Apply import policy downgrade to a foreign vouched reputation.
compute_action_ref agent_id, action_type, scope_required, timestamp
Compute content-addressed request identity (SHA-256 of agentId + actionType + scope + normalized timestamp). Two receipts with the same action_ref describe the same request.
is_evidence_fresh type, valid_at, ttl, max_age, now
Check whether typed attestation evidence is still fresh. Rotating evidence requires a ttl, snapshot evidence takes an optional maxAge, and static evidence is always fresh.
classify_evidence_quality method, has_issuer_signature, has_principal_binding, evidence
Classify attestation evidence quality (none / issuer_vouched / infrastructure / principal_bound) and return the corresponding grade (0-3).
rotate_key mode, old_private_key, agent_name, activation_delay_hours, delegation_ids_to_revoke
Rotate an agent's Ed25519 key. Planned mode: configurable overlap (default 24h). Emergency mode: immediate old-key retirement. Builds a rotated DID document for the old key, generates a new key pair, and returns a text summary with the rotation state, the first 16 hex characters of the old and new public keys, the full new private key (redacted on a remote server, MCP_TRANSPORT=sse or MCP_REMOTE=1, as in generate_keys), the DID, the rotation log entry count, and the activation time. The DID document itself is not returned, and nothing is persisted. Delegation revocation is not integrated in this server, so a non-empty delegation_ids_to_revoke is refused before any key is generated.
verify_rotation_chain did_document
Verify all rotation signatures in a DID document's rotation log. Returns true if the full chain is cryptographically valid.
is_key_active did_document, public_key
Check if a public key is currently authorized for active operations in a DID document. SDK convenience check. Gateway enforcement is authoritative.
aps_create_attribution_receipt citer, citer_public_key, citer_private_key, cited_principal, cited_principal_public_key, citation_content, binding_context, gateway_id, ttl_ms
Representation boundary: build a citer-signed AttributionReceipt attributing a claim to a third-party principal. Each party is named by a self-certifying DID that commits to the key beside it, so a receipt naming a party by a bare public key or by a did:web style identifier will not verify. The receipt is not yet valid: the cited principal must sign consent via aps_sign_attribution_consent before checkArtifactCitations accepts it.
aps_sign_attribution_consent receipt, cited_principal_private_key
Representation boundary: the cited principal adds their consent signature to an AttributionReceipt. Without this signature, verifyAttributionConsent and checkArtifactCitations reject the receipt. The signature is checked against the key the receipt carries for that party, and that key must be the one the party DID commits to.
aps_verify_attribution_consent receipt, now
Representation boundary: verify an AttributionReceipt end-to-end (id, citer signature, consent signature, expiry) and bind each named party to the key beside it. What a valid result establishes: the receipt is intact, unexpired, and signed by the keys its party DIDs commit to. What it does not establish: that either party is authorized for your relying-party decision, or who they are outside the protocol. A party named by an identifier that does not self-certify is refused as unresolved rather than assumed. Returns {valid, reason?}.
aps_check_artifact_citations artifact, receipts, binding_context
Representation boundary: gate a binding artifact's citations. Each citation must resolve to a provided, signed, unexpired receipt whose content + principal match, with per-artifact replay protection, and each receipt must bind its parties to the keys beside them. What a valid result establishes: every citation is backed by a receipt the cited principal consented to. What it does not establish: authority to act on the artifact. Receipts whose parties are named by identifiers that do not self-certify stop passing this gate.
aps_attribution_receipt_id receipt
Representation boundary helper: compute the canonical sha256 id of an AttributionReceipt's unsigned core. Verifiers use this to detect id tampering.
aps_create_provisional author, author_principal, content, author_private_key, gateway_id, dead_man_ms
Commitment boundary: emit a provisional statement for agent-to-agent negotiation. Default is non-binding until a PromotionEvent satisfies a PromotionPolicy. Dead-man expiry auto-withdraws.
aps_promote_statement statement, promotion_event, policy
Commitment boundary: promote a provisional statement to binding by attaching a PromotionEvent that satisfies the PromotionPolicy (m-of-n principal signatures). dead_man_elapsed cannot promote, because the dead-man path auto-withdraws the statement.
aps_verify_promotion statement, policy
Commitment boundary: verify that a promoted statement's PromotionEvent cryptographically satisfies the PromotionPolicy (policy_reference match, promoter in required_signers, threshold, signature, max_time_to_promote, author-signature tamper check).
aps_withdraw_provisional statement, author_signature, author_private_key
Commitment boundary: author withdraws their own provisional statement. Already-promoted statements cannot be withdrawn. Caller must supply the author's signature over the withdrawal payload (canonicalize({action:'withdraw', statement_id})).
aps_check_escalation_required delegation, action_class, action_details, session_id
Escalation boundary: check whether an action on a v2 delegation requires owner confirmation before execution. Returns {required, requirement?, reason?}. Use aps_record_owner_confirmation to clear the flag when required.
aps_record_owner_confirmation delegation, action_class, action_details, session_id, owner_private_key
Escalation boundary: owner signs an OwnerConfirmation authorizing a flagged action. Builds the ConfirmationRequest and signs it in a single call. The confirmation is bound to action_details via hash and scoped (per_action / per_session / time_window).
aps_construct_attribution_primitive action, axes, issuer, issuer_private_key, timestamp
Build and sign a four-axis AttributionPrimitive for an action. Axes: D (data sources), P (protocol modules), G (delegation chain), C (compute providers). Returns the complete signed object.
aps_project_attribution primitive, axis
Extract a single-axis projection from an AttributionPrimitive. The projection carries the axis content plus a two-hop Merkle path that lets a downstream verifier reconstruct the signed root without seeing the other three axes. axis: 'D' | 'P' | 'G' | 'C'.
aps_verify_attribution_projection projection, issuer_public_key
Verify a single-axis AttributionProjection under the issuer's Ed25519 public key. Returns {valid: true} or {valid: false, reason: 'INVALID_AXIS_TAG'|'MERKLE_MISMATCH'|'SIGNATURE_INVALID'|'MALFORMED'}. Verification is purely local and needs no other axes.
aps_verify_attribution_primitive primitive, issuer_public_key
End-to-end verify of a full AttributionPrimitive: constructs projections for all four axes and verifies each one. Useful as a post-construction sanity check or for verifying a primitive received from a peer.
aps_check_projection_consistency projection_a, projection_b
Cross-projection consistency check: given two projections, confirm they originate from the same signed receipt. Returns {same_receipt: true} or {same_receipt: false, reason: 'DIFFERENT_ACTIONS'|'DIFFERENT_RECEIPTS'|'DIFFERENT_SIGNATURES'|'METADATA_MISMATCH'}.
aps_compute_attribution_action_ref agentId, actionType, params, nonce
Derive the action_ref (hex sha256) for an action tuple. action_ref is the content-addressed anchor that all four axis projections bind to. Useful for indexing primitives by action without constructing the full primitive.
aps_compute_data_axis_weights sources, action_timestamp, profile
Compute the D-axis fractional weight vector from a list of AccessReceipt records with role, timestamp, and content length. Returns canonical DataAxisEntry[] with 6-digit decimal contribution_weight strings that sum to ~1.0 and feed directly into aps_construct_attribution_primitive. Empty input returns an empty array, and all-zero raw weights return an error. Weights = role × recency_decay × length_weight, then normalized. Parameter names match the SDK: `sources`, `action_timestamp`, optional `profile`.
aps_compute_compute_axis_weights providers, profile
Compute the C-axis fractional weight vector from a list of inference billing records (prompt_tokens, completion_tokens). Returns canonical ComputeAxisEntry[] with 6-digit decimal compute_share strings that sum to ~1.0 and feed directly into aps_construct_attribution_primitive. Weights = prompt_tokens + completion_tokens × COMPLETION_MULTIPLIER (default 3.0), then normalized. Parameter names match the SDK: `providers`, optional `profile`.
aps_aggregate_settlement receipts, period, gateway_did, gateway_private_key, issued_at
Aggregate a batch of Attribution Primitives over a half-open settlement period [t0, t1) into a signed SettlementRecord. Each axis (D, P, G, C) produces a per-contributor total with a balanced-Merkle commitment. Residual buckets pool sub-threshold contributors. Output is a fully signed record ready for third-party verification.
aps_verify_settlement record, gateway_public_key, input_receipts
Verify a signed SettlementRecord under S1-S5 (signature, Merkle roots, conservation, residual shape, optional input-receipts cross-check). S3 conservation is the strongest invariant: a gateway cannot inflate or suppress any contributor's share without breaking it. Returns {valid: true} or {valid: false, reason, detail}. Pass inputReceipts to also recompute input_receipts_hash.
aps_build_contributor_query record, contributor_did, gateway_jwks
Build a contributor-query response: given a signed SettlementRecord and a contributor DID, return per-axis (total_weight, contribution_count, merkle_path, axis_root) plus the full signed record so a third party can verify the contributor's share end-to-end without trusting the gateway beyond its public key. Returns null if the contributor has no share in the period.
mutualAuthBuildCertificate role, subject_id, subject_pubkey_hex, issuer_id, issuer_role, issuer_pubkey_hex, issuer_privkey_hex, binding, not_before, not_after, supported_versions, attestation_grade, capabilities
Build and sign a mutual-auth certificate identifying an agent or information system. Returns the signed MutualAuthCertificate object ready to carry into a handshake. The issuer's Ed25519 private key (hex) signs over the canonical (JCS) form.
mutualAuthVerifyAttest attest, expected_peer_nonce_b64, expected_own_nonce_b64, policy, trust_anchors, revoked_anchor_ids, now_ms
Verify a MutualAuthAttest against policy and trust anchors. Runs all 10 verification checks: signature, version negotiation, nonce match, timestamp freshness, certificate validity, issuer anchor check, binding constraints, downgrade detection, attestation grade policy, capability policy. Returns ok:true on success or a failure reason on rejection.
mutualAuthDeriveSession agent_attest, is_attest, policy, now_ms
Derive the shared mutual-auth session record from both sides' Attests. Both parties MUST compute identical session_id given identical inputs (canonical JCS + sha256 of chosen_version, both cert ids, both nonces). Returns a MutualAuthSession with session_id + both certificates + expiry bounds, or failure reason.
mutualAuthVerifyTrustBundle bundle, trusted_publisher_pubkeys_hex, now_ms
Verify a TrustAnchorBundle signature and freshness. Caller supplies the list of trusted publisher public keys (root configuration). Returns ok:true on success or failure reason (untrusted_publisher, signature_invalid, bundle_expired, not_yet_valid).
aps_capability_issue_challenge sink_id, subject_id, action, sink_private_key, sink_public_key, validity_seconds, required_policy_freshness
v0.1 capability-token sink challenge (M1). Sink issues a signed canonical action statement. Returns the SinkChallenge and its challenge_hash. Used to bind the gateway's later policy evaluation to a specific action the sink authored. Search keywords: capability token, sink challenge, M1.
aps_capability_evaluate_authority challenge, delegation_chain, authority_token, freshness_beacon, subject_private_key, subject_public_key, delegation_chain_root
v0.1 capability-token authority evaluation request (M2). Subject signs a request carrying the sink's M1, the delegation chain, and a revealed authority-token preimage. The gateway consumes this to decide permit/deny. Search keywords: capability token, authority evaluation, M2.
aps_capability_mint_receipt request, decision, deny_reason, policy_digest, gateway_private_key, gateway_public_key
v0.1 capability-token gateway receipt (M3). Gateway signs a permit or deny over the sink's exact challenge_hash. Echoes the M2 delegation_chain_root so the sink can verify the gateway saw the same chain the subject committed to. Search keywords: capability token, challenge receipt, gateway receipt, M3.
aps_capability_sign_effect challenge, challenge_receipt, effect, sink_private_key, sink_public_key, gateway_public_key, expected_delegation_chain_root
v0.1 capability-token sink effect receipt (M4). The sink verifies the gateway's M3, consumes the token preimage (rejecting a replayed nullifier), and signs an EffectReceipt binding the consumed token to the action result the caller supplies. This tool does not execute the action. The (M1, M3, M4) tuple is the full attestation record. Search keywords: capability token, effect receipt, M4, sink attestation.

Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.

Install facts

LicenseApache-2.0
Needsnode >=20
Sourcegithub.com/agent-passport-system/agent-passport-mcp
Install scriptsagent-passport-system-mcp declare them. This runner does not run them.
Tarballsha512-ad74Z3aGJ9zzic8DaMcRYjyPHvGPZn182NQyHGQ9CXw/bkwT7ZoOX8kTxUc/2UTk3VLKoR4+uV5Fh4CJYpKYYQ==

Check this report yourself

This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.

Show it on your README

Bragproof: Starts with no setup

[![Bragproof](https://bragproof.smaverk.com/badge/agent-passport-system-mcp.svg)](https://bragproof.smaverk.com/r/agent-passport-system-mcp)

New version out? Ask for a fresh report.