OnceAsk MCP
Gerenciar endereços de correspondência dinamicamente
Documentação
OnceAsk MCP — Contatos + Endereços de Correspondência Atuais
Repositório oficial de descoberta do MCP para OnceAsk, um MCP de contatos e agenda de endereços para agentes de IA que precisam do endereço de correspondência atual de uma pessoa, não apenas o último endereço armazenado em um registro de contato.
Endereços mudam. O OnceAsk os mantém atualizados.
O OnceAsk ajuda um assistente de IA a resolver uma pessoa conhecida para um destino de entrega atual e autorizado, ou solicitar uma atualização quando o endereço estiver ausente ou desatualizado.
Endpoint do MCP
https://onceask.com/_api/mcp
Transporte: Streamable HTTP
Identidade do registro: io.github.rsb6061/onceask
O que torna o OnceAsk diferente
Uma integração convencional de contatos pode informar a um agente quem é uma pessoa e expor quaisquer campos armazenados para esse contato. O OnceAsk foca no próximo problema: o endereço de correspondência desta pessoa está atualizado e utilizável para esta ação de entrega física?
O OnceAsk pode retornar um estado de entrega explícito em vez de tratar um endereço salvo como automaticamente atual:
authorized— o destinatário está pronto para uma ação de entrega autorizada.permission_required— solicitar permissão do destinatário.address_update_required— pedir ao destinatário para confirmar ou atualizar o endereço atual.ambiguous— perguntar ao usuário qual pessoa correspondente ele quer dizer.not_found— coletar ou criar o destinatário primeiro.
Ferramentas principais do MCP
resolve_delivery
Resolver uma pessoa ou contato conhecido para um estado de entrega atual. Esta é a primitiva preferida para agentes de IA que precisam enviar algo físico.
request_delivery_permission
Acionar o fluxo de confirmação do destinatário quando um endereço estiver ausente, desatualizado ou ainda não autorizado.
list_handwritten_cards
Listar os designs de cartões e estilos de caligrafia suportados pela Handwrytten sem expor dados do destinatário.
send_handwritten_card
Cumprir uma entrega de cartão autorizada usando um token de entrega opaco. O fluxo preferido não retorna o endereço físico bruto do destinatário como saída comum do modelo.
Exemplos de fluxos de trabalho do agente
- "Envie um cartão de aniversário para a tia Theresa."
- "Envie um presente de agradecimento para este cliente."
- "Obtenha o endereço de correspondência atual de John antes de enviarmos o convite."
- "Pergunte a Sarah qual é o novo endereço dela."
- "Envie o documento para Mike sem depender do endereço no nosso registro antigo do CRM."
O agente pode identificar a pessoa a partir do contexto existente e, em seguida, usar o OnceAsk para resolver o estado de entrega atual.
Links úteis
- Contacts MCP
- Address Book MCP
- Visão geral do MCP
- Início rápido para desenvolvedores
- Documentação para desenvolvedores
- Agenda de endereços para agentes de IA
- API de endereço de correspondência
- Guia legível por agentes
- Esquema OpenAPI
- Manifesto do MCP
Listagens de diretório ao vivo
Essas listagens apontam para o mesmo endpoint de produção e identidade de registro: io.github.rsb6061/onceask.
Registro do MCP
Os metadados do registro são definidos em server.json.
Para verificar a listagem oficial do registro:
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.rsb6061/onceask"