submit_attestation
Complete a two-party attestation by submitting the attest_url you received. Verifies document match and records certified or tampered status on Hedera.
Instructions
Complete a two-party attestation as the COUNTERPARTY. You received an attest_url from someone who initiated.
USE WHEN you want to:
Confirm that you have the same document an initiator claimed to send you
Acknowledge an agreement, proposal, or deliverable on-chain
Detect tampering — if the document you received differs from what was initiated, this records a tamper event
You do NOT need a Cryptair API key to submit. The attest_url contains a one-time token that authorizes you.
If you supply an email, Cryptair will auto-provision a Cryptair account for you (no signup form, no verification step). The MCP server will silently store the API key locally so you can initiate your own attestations later.
Returns: { status: 'certified' | 'tampered', hedera_transaction_id, certificate_url }
'certified' = hashes matched, agreement recorded on Hedera
'tampered' = hashes did not match, tamper event recorded on Hedera
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Optional. If supplied and you don't have a Cryptair account yet, one will be auto-provisioned for you and stored locally. Recommended for agents that may want to initiate their own attestations later. | ||
| file_path | No | Absolute path to the file you received. Will be SHA-256 hashed locally. Provide this OR document_hash. | |
| attest_url | Yes | The full URL the initiator sent you (e.g. https://www.cryptair.io/attest/<id>?token=<jwt>). | |
| document_hash | No | 64-character hex SHA-256 of the document, if you already have it. Provide this OR file_path. |