# agent-handoff-certified-mcp
# Purpose: Cryptographically signed handoff certificates when agent A passes a task to agent B.
# Context: Prevents 'agent B silently picks up a task outside its authorisation'. Required for multi-agent enterprises.

## Install
```bash
pip install agent-handoff-certified-mcp
```

## Auth & Rate Limits
- Free tier: 10 calls/day. No API key required.
- Pro tier (£79/mo): unlimited + signed attestations. https://buy.stripe.com/14A4gB3K4eUWgYR56o8k836
- Enterprise (£1,499/mo): white-label + on-premise. hello@meok.ai
- All tools accept optional `api_key` parameter.

## Tools (5)

### `initiate_handoff(tenant_id: str, from_agent: str, to_agent: str, task: str, context_json: str = "{}", expires_in_seconds: int = 300)`
Initiating agent offers a task. Returns handoff_id + signed offer.

### `accept_handoff(handoff_id: str, accepting_agent_id: str, accepting_agent_ref: str = "")`
Receiving agent accepts + signs. Completes the chain.

### `verify_chain(handoff_id: str)`
Re-verify the handoff signatures. Returns full trace + integrity status.

### `list_handoffs(tenant_id: str, status_filter: str = "", limit: int = 25)`
List handoffs for a tenant, optionally filtered by status.

### `sign_handoff_chain_attestation(tenant_id: str, window_start_utc: str, window_end_utc: str, email: str = "")`
Emit a signed attestation of the handoff chain integrity for a window. Pro+.

## Pairs with
- `meok-attestation-verify` — public verification of signed certs
- `meok-attestation-api` (https://meok-attestation-api.vercel.app) — HMAC signing endpoint
- Other MEOK governance MCPs via `mcp_bridge_call`

## Maintainer
MEOK AI Labs · hello@meok.ai · https://meok.ai · MIT licensed