{
  "name": "OnceAsk",
  "description": "Recipient-owned address permissions and privacy-preserving physical delivery for AI agents.",
  "version": "1.4.0",
  "endpoint": "https://onceask.com/_api/mcp",
  "protocol_versions": ["2026-07-28", "2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"],
  "authentication": {
    "type": "oauth2_or_bearer_api_key",
    "description": "ChatGPT and other consumer clients should connect with OAuth 2.1 + PKCE. Developers may also use a OnceAsk API key with least-privilege scopes.",
    "oauth_protected_resource_metadata": "https://onceask.com/.well-known/oauth-protected-resource.json"
  },
  "preferred_tool": "resolve_delivery",
  "tools": [
    {
      "name": "resolve_delivery",
      "description": "Resolve an authorized recipient to a short-lived one-time delivery token without returning their street address.",
      "required_scope": "resolve_delivery"
    },
    {
      "name": "request_delivery_permission",
      "description": "After user confirmation, request a current delivery address/permission by recipient ID or person name. OnceAsk can discover a connected Google/Gmail-derived contact and email the secure confirmation without exposing recipient email or street address to the agent.",
      "required_scope": "resolve_delivery"
    },
    {
      "name": "list_handwritten_cards",
      "description": "List available Handwrytten card designs and handwriting styles without accessing recipient address data.",
      "required_scope": "resolve_delivery"
    },
    {
      "name": "send_handwritten_card",
      "description": "Use an authorized opaque delivery token to submit a handwritten card through Handwrytten without returning the recipient street address to the agent.",
      "required_scope": "resolve_delivery"
    },
    { "name": "search_contacts", "required_scope": "read_contacts" },
    { "name": "get_contact", "required_scope": "read_contacts" },
    { "name": "list_contacts", "required_scope": "read_contacts" },
    { "name": "find_missing_mailing_addresses", "required_scope": "read_contacts" },
    { "name": "request_contact_update", "required_scope": "write_contacts" },
    { "name": "create_collection", "required_scope": "create_collections" },
    { "name": "get_collection_status", "required_scope": "create_collections" },
    { "name": "export_contacts_for_vendor", "required_scope": "export_contacts" },
    { "name": "share_contacts_with_provider", "required_scope": "manage_providers" },
    { "name": "revoke_provider_access", "required_scope": "manage_providers" }
  ],
  "privacy": {
    "default_delivery_mode": "opaque_token",
    "raw_address_is_default": false,
    "recipient_permission_required": true,
    "delivery_tokens_are_one_time": true,
    "delivery_tokens_are_short_lived": true,
    "preferred_fulfillment_mode": "server_to_server"
  },
  "discovery": {
    "docs": "https://onceask.com/docs",
    "llms": "https://onceask.com/llms.txt",
    "agents": "https://onceask.com/agents.txt",
    "openapi": "https://onceask.com/.well-known/openapi.json"
  }
}