# cardano.delivery

> Free webhooks for the Cardano blockchain (mainnet). Get signed HTTP notifications, or poll stored events, for transactions, blocks, delegations, epochs, governance proposals, votes, DReps, pools, withdrawals, mints, script executions and account changes. Built to be usable by AI agents without an account.

## Ephemeral webhooks (no account needed - ideal for agents)

Create a temporary webhook with one request. Default TTL 1 hour, max 24 hours.
Omit target_url to use inbox mode: matched events are stored and you poll them,
so you need no public HTTP endpoint.

Create (inbox mode):

    curl -X POST https://cardano.delivery/api/ephemeral \
      -H "Content-Type: application/json" \
      -d '{"type": "transaction", "ttl_seconds": 3600,
           "conditions": [{"type": "recipient", "operator": "=", "value": "addr1..."}]}'

Response includes: id, manage_token (keep it - shown once), events_url, expires_at.

Poll matched events:

    curl https://cardano.delivery/api/ephemeral/{id}/events \
      -H "Authorization: Bearer eph_your_manage_token"

Each event row has fired_at, payload (the event JSON) and success. Delete early
with DELETE /api/ephemeral/{id} (deactivates it; history is kept). If you pass a target_url instead, events are
POSTed there, signed via the Delivery-Signature header (t=timestamp,v1=hex
HMAC-SHA256 of "timestamp.body" using the returned auth_token).

Webhook types: transaction, block, delegation, epoch, proposal, vote, pool,
withdrawal, mint, script, drep, account. Conditions are AND-combined
{type, operator, value, selector?} objects; jsonPath conditions query any
payload field. Full condition reference: https://cardano.delivery/docs/

Limits: 5 ephemeral webhooks per hour per IP, up to 5 conditions,
confirmations 1-10 (block-cascade types only).

## MCP server

MCP-capable agents can use the remote MCP endpoint instead of raw HTTP:

    https://cardano.delivery/mcp   (Streamable HTTP, no auth)

Claude Code: claude mcp add --transport http cardano-delivery https://cardano.delivery/mcp
Tools: create_webhook, poll_events, get_webhook_status, deactivate_webhook.

## Permanent webhooks (free account)

Sign up at https://cardano.delivery/app/ (5 webhooks, API keys for
programmatic management). REST API reference: https://cardano.delivery/docs/api/

## Docs

- Documentation: https://cardano.delivery/docs/
- API reference: https://cardano.delivery/docs/api/