The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the OnceAsk listing page.
Official MCP discovery repo for OnceAsk, a contacts and address-book MCP for AI agents that need a person's current mailing address, not just the last address stored in a contact record.
Addresses change. OnceAsk keeps them current.
OnceAsk helps an AI assistant resolve a known person to a current, permissioned delivery destination or request an update when the address is missing or stale.
https://onceask.com/_api/mcp
Transport: Streamable HTTP
Registry identity: io.github.rsb6061/onceask
A conventional contacts integration can tell an agent who a person is and expose whatever fields are stored for that contact. OnceAsk focuses on the next problem: is this person's mailing address current and usable for this physical-delivery action?
OnceAsk can return an explicit delivery state instead of treating a saved address as automatically current:
authorized — the recipient is ready for an authorized delivery action.permission_required — request recipient permission.address_update_required — ask the recipient to confirm or update the current address.ambiguous — ask the user which matching person they mean.not_found — collect or create the recipient first.resolve_deliveryResolve a known person or contact to a current delivery state. This is the preferred primitive for AI agents that need to send something physical.
request_delivery_permissionTrigger the recipient-confirmation flow when an address is missing, stale, or not yet authorized.
list_handwritten_cardsList supported Handwrytten card designs and handwriting styles without exposing recipient data.
send_handwritten_cardFulfill an authorized card delivery using an opaque delivery token. The preferred flow does not return the recipient's raw street address as ordinary model output.
The agent can identify the person from its existing context, then use OnceAsk to resolve the current delivery state.
These listings point to the same production endpoint and registry identity: io.github.rsb6061/onceask.
The registry metadata is defined in server.json.
To verify the official registry listing: