A2H: ask a human
andreaacanfora/a2h-gateway
Ask a human before acting: approvals by email, Telegram or push, signed answers, passkeys.
- tools
- 5
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Nov 9, 2026
Tools
5 toolsPublic tool metadata for what this MCP can expose to an agent.
request_approvalAsk you to approve or decline an action; returns the verified decision
Ask you to approve or decline an action; returns the verified decision
No parameter schema in public metadata yet.
ask_humanAsk you to fill in a short form (text, numbers, dates, choices, yes/no)
Ask you to fill in a short form (text, numbers, dates, choices, yes/no)
No parameter schema in public metadata yet.
notify_humanSend you a message (progress, result, alert)
Send you a message (progress, result, alert)
No parameter schema in public metadata yet.
check_requestFollow up on a request that is still waiting
Follow up on a request that is still waiting
No parameter schema in public metadata yet.
cancel_requestWithdraw a request that has not been answered
Withdraw a request that has not been answered
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
A2H_GATEWAY*URL of your A2H gateway, e.g. https://a2h.example.com
A2H_API_KEY*secretAPI key of the gateway
A2H_TO*Where to reach you: mailto:you@example.com, tg:<chat_id> or an ntfy topic URL
A2H_PRINCIPALYour principal ID on the gateway (optional)
Readme
a2h-gateway
A self-hosted gateway for A2H, the Agent-to-Human protocol: AI agents and scripts ask a person for approval or information, the person answers from email, Telegram or a push notification, and the agent gets a signed answer with proof of who decided. A single Go binary with SQLite.
$ a2h ask -to mailto:me@example.com -why "Rolls back if health checks fail." "Deploy v2.3 to production?"
Waiting for an answer from mailto:me@example.com (interaction 01a1bbcf-…)…
Approved (email_link.v1) at 2026-11-08T15:37:50Z.
$ echo $?
0
A2H was published by Twilio Labs in February 2026 with a specification, an OpenAPI schema and a proof-of-concept demo. Its roadmap lists a reference gateway and formal JSON Schemas as next steps. This project is an independent implementation of both, not affiliated with Twilio.
What it does
Details
- Repository
- github.com/andreaacanfora/a2h-gateway
- Website
- github.com/AndreaAcanfora/a2h-gateway#use-it-from-ai-agents-mcp
- Category
- Communication & Messaging
- Package
ghcr.io/andreaacanfora/a2h-gateway:0.3.0- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
