andreaacanfora avatar

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 tools

Public 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

Configuration

A2H_GATEWAY*

URL of your A2H gateway, e.g. https://a2h.example.com

A2H_API_KEY*secret

API key of the gateway

A2H_TO*

Where to reach you: mailto:you@example.com, tg:<chat_id> or an ntfy topic URL

A2H_PRINCIPAL

Your principal ID on the gateway (optional)

Readme

a2h-gateway

CI

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


View the full README on GitHub

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

Related Communication & Messaging MCP servers

View all
1eztexting avatarEZTexting MCPeztexting/mcp-serverOfficial EZTexting MCP server: SMS/MMS messaging, contacts, workflows, reports.0stars
2mailbox-mcp avatarMailbox MCPcom.mailbox-mcp/mailbox-mcpRead, send, file and search email in any Gmail, Microsoft 365 or IMAP mailbox, plus its calendar.0stars
3pingfyr avatarPingfyrpingfyr/mcpSchedule reminders for AI agents via email, webhook, Slack, Discord, Telegram, or Google Calendar.0stars
4danboabes avatarMCPDomaindanboabes/mcpdomainBuy & manage domains from any AI chat: availability, register, DNS, email forwarding, AI bot stats.0stars
5chamade-io avatarChamadechamade-io/mcp-serverVoice and chat for AI agents — Discord, Teams, Meet, Slack, Zoom, Telegram, WhatsApp, NC Talk, SIP0stars
6evozim avatarDocDigestio.github.evozim/docdigestCorporate email and chat thread summarization parser.0stars