用途:通过 Sent MCP 工具查询电话号码能力,并获取消息发送量、送达率和联系人等聚合分析,用于账户级指标查看与对比。
主要能力:numbers.lookup 查询号码的可用能力、格式、类型或路由信号;dashboard.messages_sent 统计已送达/已读的短信与 WhatsApp 出站量,支持 15 分钟、小时或每日粒度;dashboard.deliverability 返回全时段出站百分比 (SENT + DELIVERED + READ) / (全部除去 FILTERED 与 BLOCKED);dashboard.contacts 返回当前联系人总数快照。
使用方式:采用客户端管理的 OAuth 2.1/PKCE,不请求或暴露令牌、API 密钥、授权头、客户端 ID 或密钥。需明确当前组织与发送者配置;组织授权可用可选 profileId 选择自有 Sender Profile,须先用 sender_profiles.list 或 get 验证归属,并在预读、变更与后续读取中使用同一选择器。
限制:numbers.lookup 具状态变更且非幂等,即使不发送消息;付费查询额度为每个认证账户范围每 UTC 日 1000 次,跨操作配置共享,00:00 UTC 重置,遇配额错误不应轮换配置或循环重试。送达率为全时段指标,非日期限定成功率;联系人仅为快照,不能证明增长或趋势。查询结果不代表用户已选择加入、同意、拥有号码或获得发送许可。对比须保持同一组织、操作配置、时间窗口、时区、渠道覆盖与粒度,并将“已接受”与“已送达”区分标注。