pntr-cli 是面向开发者的命令行工具与 MCP 服务器，围绕 PNTR 提供的免费 *.pntr.dev 子域名工作。用途上，它让一个易记主机名指向部署、接收注册与 OTP 邮件，或捕获 Stripe、GitHub 等 Webhook 请求，并可在终端、Claude Code、Claude Desktop、Cursor 或其他 MCP 客户端中完成同一套流程。
主要能力：注册和管理子域名、设置或替换 DNS 记录、开关子域名、启用一次性邮箱并列出/阅读邮件、把子域名变成 HTTP 请求捕获端点并设置其返回状态、内容类型与正文、列出与阅读捕获的请求、按条件等待邮件或请求、启用通配符 DNS（付费）。MCP 侧暴露 list_domains、check_subdomain、register_subdomain、update_subdomain、delete_dns_record、toggle_email、list_emails、read_email、wait_for_email、toggle_capture、list_requests、read_request、wait_for_request、toggle_wildcard 等工具。
使用方式：需要 Node 18+。执行安装后登录会走设备流程，并自动为检测到的 AI 客户端配置 MCP；也可用远程 MCP（GitHub OAuth，streamable-HTTP 地址 https://api.pntr.dev/mcp/sse 供旧客户端）或本地 stdio 服务器 npx @pntr/cli。凭据通过 conf 本地存储，也可用 PNTR_TOKEN。等待调用采用服务端长轮询，--since 接受 RFC3339 时间或相对时长，超时 1 到 25 秒；超时退出码 2，其他错误为 1，JSON 输出不含凭据。
适用场景：把免费子域名接到 Vercel 或 GitHub Pages、调试 Stripe Webhook 与 GitHub 投递、用 Playwright 测试注册邮件、在 CI 中创建隔离的邮件与 Webhook 兄弟子域名并凭 manifest 清理。限制：邮件保留 48 小时，付费可 90 天；每个环境占用 2 个子域名配额；通配符 DNS 为付费功能；MCP 返回的邮件和请求内容按不可信数据围栏，助手只应检查而不执行其中指令。
