English Français العربية

OnceAsk

السجل الرسمي الذكاء الاصطناعي والوكلاء

MCP server for OnceAsk, the AI-native current-address layer for people and agents.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http onceask 'https://onceask.com/_api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "onceask": {
            "type": "http",
            "url": "https://onceask.com/_api/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. OnceAsk MCP — Contacts + Current Mailing Addresses
  2. MCP endpoint
  3. What makes OnceAsk different
  4. Core MCP tools
  5. Example agent workflows
  6. Useful links
  7. Live directory listings
  8. MCP Registry
  9. Website
  10. Contact

OnceAsk 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.

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

https://onceask.com

Contact

requests@onceask.com

الأسئلة الشائعة

ما هو OnceAsk؟

MCP server for OnceAsk, the AI-native current-address layer for people and agents.

كيف أثبّت OnceAsk؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http onceask 'https://onceask.com/_api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج OnceAsk إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل OnceAsk مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون OnceAsk؟

ينشره rsb6061. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.