About OnceAsk
OnceAsk is a contacts and address-book MCP server for agents that need a person's current mailing destination. It checks permission and address status before physical delivery, rather than treating saved contact details as current.
Key features
- 01Resolve a contact’s delivery status
- 02Request recipient permission or updates
- 03List handwritten card designs
- 04Send cards with delivery tokens
Use cases
- 01Check an address before mailing a gift
- 02Ask a recipient to confirm a stale address
- 03Send an authorized handwritten card
MCP support
OnceAsk exposes contact delivery resolution and handwritten-card tools through the MCP endpoint at `https://onceask.com/_api/mcp`. It reports whether delivery is authorized, needs permission or an address update, is ambiguous, or has no match.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://onceask.com/_api/mcpclaude mcp add --transport http rsb6061-onceask https://onceask.com/_api/mcp{"mcpServers":{"rsb6061-onceask":{"type":"http","url":"https://onceask.com/_api/mcp"}}}Open in Cursor{"servers":{"rsb6061-onceask":{"type":"http","url":"https://onceask.com/_api/mcp"}}}Open in VS Code{"mcpServers":{"rsb6061-onceask":{"type":"http","url":"https://onceask.com/_api/mcp"}}}{"mcpServers":{"rsb6061-onceask":{"serverUrl":"https://onceask.com/_api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | No | Name or email to resolve when contact ID is not known |
| purpose | string | No | Purpose for the physical delivery |
| contactId | string | No | Known OnceAsk contact ID |
Details
From the project READMEOnceAsk MCP — Contacts + Current Mailing Addresses
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.
MCP endpoint
https://onceask.com/_api/mcp
Transport: Streamable HTTP
Registry identity: io.github.rsb6061/onceask
What makes OnceAsk different
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.
Core MCP tools
resolve_delivery
Resolve 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_permission
Trigger the recipient-confirmation flow when an address is missing, stale, or not yet authorized.
list_handwritten_cards
List supported Handwrytten card designs and handwriting styles without exposing recipient data.
send_handwritten_card
Fulfill 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.
Example agent workflows
- "Send Aunt Theresa a birthday card."
- "Mail this client a thank-you gift."
- "Get John's current mailing address before we send the invitation."
- "Ask Sarah for her new address."
- "Send the document to Mike without relying on the address in our old CRM record."
The agent can identify the person from its existing context, then use OnceAsk to resolve the current delivery state.
Useful links
- Contacts MCP
- Address Book MCP
- MCP overview
- Developer quickstart
- Developer docs
- AI agent address book
- Mailing address API
- Agent-readable guide
- OpenAPI schema
- MCP manifest
Live directory listings
These listings point to the same production endpoint and registry identity: io.github.rsb6061/onceask.
MCP Registry
The registry metadata is defined in server.json.
To verify the official registry listing:
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.rsb6061/onceask"
Website
Contact
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.