使用 AvatarLookup MCP 服务器：工具、输入与限制
了解四个已记录的 AvatarLookup MCP 工具，明确何时使用标识符检查，以及为何图片上传和批量文件处理需使用 REST API。
AvatarLookup 的 MCP 服务器为兼容的 AI 助手提供基于账户的标识符检查、产品列表查询和余额查询功能；图片上传和批量任务则使用独立的工作流。
位于 https://avatarlookup.com/mcp 的 AvatarLookup MCP 服务器提供了四个已记录的工具：list_products、check_number、check_numbers 和 get_balance。当 AI 助手需要查看支持的产品或使用现有账户进行小规模的标识符头像检查时，这些工具非常有用。上传图片和异步批量文件任务属于不同的作业，目前没有记录在案的 MCP 工具，因此这些工作流应在网站或通过 REST API 完成。
从您实际拥有的输入开始
头像解析始于证据来源。如果团队已经拥有图片，则使用 AvatarLookup 的图片人像解析功能对图片本身进行分析。网站接受上传的图片或公开的 HTTPS 图片 URL；已记录的 API 路径使用 multipart 文件上传。这是一个图片工作流，而非标识符检查，且目前没有记录在案的图片上传 MCP 工具。
如果团队拥有 WhatsApp 号码或受支持域名的邮箱地址，则标识符检查可以分析该来源可用的公开头像。WhatsApp 以及受支持的 Gmail、Yandex 和 Mail.ru 地址支持实时单次和同步多次检查。这些检查会在发起的请求流中返回结果。其他已记录的通讯来源仅提供批量文件产品，而非实时单次检查工具。
在配置助手之前，这种区别至关重要。MCP 客户端不应推断名为 check_number 的工具接受目录中的所有来源，也不应认为邮箱或用户名可以通用地提交给任何工具。请查阅所选来源的当前产品列表和文档。保留一份记录，说明所提供的内容是：图片、电话号码、用户名还是邮箱地址。结果的解读取决于该输入。
每个已记录 MCP 工具的作用
这四个工具名称定义了一个刻意精简的助手界面。list_products 允许客户端查看通过已记录集成可用的产品。check_number 用于单个受支持的标识符检查。check_numbers 处理一组受支持的、同一服务类型的标识符的同步检查。get_balance 报告现有账户余额。该服务器是访问同一账户的途径，而非独立的检测服务或第二个额度池。
一个实用的助手工作流是：询问哪种产品适合该来源，仅提交预期的标识符，然后描述返回的信号及其来源和时间。助手不应将头像结果重新解读为身份识别结果。来自图片的形象估计是算法生成的，结果可能是无法判定。公开可用头像的存在与否，并不代表账户所有者的身份。
避免将账户密钥粘贴到聊天文本、示例或共享截图中。请遵循当前 AvatarLookup 针对 MCP 客户端的连接说明，并将身份验证信息保存在客户端的受保护配置中。确切的凭据交换应来自当前文档；本文档不会虚构示例配置或声称存在未记录的设置命令。团队还应决定哪些用户可以调用检查，因为客户端请求会使用与网站和 REST API 相同的账户余额。
MCP 的边界在哪里
上传的照片是图片人像解析的输入。已记录的 REST 图片路径使用 multipart 上传，而网站也可以接受公开的图片 URL。目前没有记录在案的 MCP 上传工具。助手可以协助制定本地审查计划，但不应声称已通过 check_number 分析了图片。
大型列表是另一个独立的路径。AvatarLookup 针对受支持的电话、用户名和邮箱来源，拥有八种不同的异步批量产品。批量任务以 TXT 或 CSV 文件开始，返回任务引用，并在成功处理后生成一个 CSV 文件。已记录的 REST 路径始于 POST /api/v1/bulk-tasks，并使用 GET /api/v1/bulk-tasks/{id} 查看状态。MCP 工具列表中没有批量提交或文件下载工具。进行同步小规模调用的客户端不应被视为批量任务的替代品。
批量产品具有来源特异性。Telegram 号码和用户名、Viber、MAX、LINE 和 Zalo 仅记录了批量检查产品，而非实时单次检查。对于这些来源，请选择相应的文件产品并阅读其各自的结果定义。不要虚构通用的 avatar_bulk 产品，也不要假设一个 CSV 模式适用于所有产品。
围绕不确定性设计助手回答
一个有用的助手回答应识别来源并说明发现的含义。例如，它可以说明某个已检查标识符存在公开头像，或者所选的分析产生了算法生成的图片属性。如果未返回公开头像，助手应避免断言该账户不存在。如果检查结果为无法判定或失败，助手应说明结果不确定，而不是将其转化为负面的头像结论。
结果存在与账户存在之间的区别在同步多次检查中尤为重要。已记录的 exists 标志表示已生成结果。它不是通用的账户存在标志；false 值可能反映了无效、无法判定或失败的检查。已完成的负面头像或注册结果仍然可以是已完成的、可计费的分析。助手应依赖所选产品的含义，而不是将多个字段简化为一个“已验证”标签。
形象属性是估计值，而非人口统计学事实。宠物、插图或物体也可以产生已完成的图片分析。团队应避免将此类属性用于关于人员的重要决策。仅存储联系人数据任务所需的输出，按来源和检查日期进行标记，并将模糊的记录留给人工审查。这些是团队的治理选择，而非 MCP 提供的隐藏保证。
实用采用清单
在连接助手之前，请确定团队需要的来源类型，以及每种类型是否支持实时检查。确认用户拥有处理这些标识符的权限。请查阅当前的 AvatarLookup 产品文档以了解产品名称，查阅 API 文档以了解请求和结果规则，并查看 MCP 端点当前的连接指南。
在小型试点期间，记录助手选择了哪个工具、提供了哪种标识符，以及回答如何描述不确定性。将助手的总结与实际产品结果进行比较。如果助手在一次不确定的头像检查后说“无账户”，则需要纠正其指令后再进行更广泛的使用。试点无需假设任何准确率或处理时间。
当用例更改为图片或大文件时，请明确更改工作流。对于图片，请使用网站图片输入或已记录的图片 API。对于大型列表，请使用来源特定的 REST 批量任务。这使助手的功能与四个已记录的 MCP 工具保持一致，并使每个结果更容易向审查联系人记录的同事解释。
常见问题解答
助手如何通过 AvatarLookup MCP 服务器上传图片？
目前没有记录在案的图片上传 MCP 工具。对于团队已有的图片，请使用网站的图片输入或已记录的 multipart REST 图片路径。
check_numbers 可以替代批量头像文件任务吗？
不能。check_numbers 是针对受支持标识符的同步小规模多次检查路径。大型文件产品是独立的异步 REST 任务，具有来源特定的准备工作和可下载的 CSV 文件。
当头像检查结果不确定时，助手应该说什么？
助手应将结果标识为所选产品下的无法判定或失败，而不是断言账户或头像不存在。审查人员可以决定是否需要进行后续检查。
MCP 服务器有自己的余额吗？
没有。已记录的 MCP 工具使用现有的 AvatarLookup 账户。get_balance 工具读取的是该账户余额，而非独立的 MCP 分配额度。
了解更多
选择适合您工作流下一步的产品信息。