BizVerify

BizVerify MCP 服务

面向 AI Agent 的 KYB——直接通过任意 MCP 客户端，验证和搜索美国各州及国际公司注册机构中的商业实体。

BizVerify 通过实时读取政府官方商业注册信息，确认公司的合法存在、状态、良好信誉、注册代理人、高管和备案历史。

BizVerify MCP 服务的规范版本以 托管 的 Streamable HTTP 端点形式提供：

https://api.bizverify.co/mcp

此仓库将该服务打包为本地 stdio 桥接程序（另提供 Docker 镜像），供需要本地进程的 MCP 客户端和沙箱使用。该桥接程序是一个轻量透明代理——工具定义和结果均直接来自托管服务，因此始终保持同步。

工具

工具	身份验证	功能
get_config	–	支持的司法辖区、点数定价、套餐和功能
list_jurisdictions	–	所有司法辖区及其能力和启用状态
verify_business	✅	在一个司法辖区内确认指定名称的企业——存在情况、状态、良好信誉（快速）；以及实体类型、成立日期、注册代理人、高管、主要地址和备案信息（深入）
search_entities	✅	按名称在一个或所有启用的司法辖区中查找候选企业
check_job_status	✅	轮询异步验证任务（免费）
get_entity	✅	按 ID 检索缓存的实体数据（免费）
get_entity_history	✅	获取实体的历史验证快照
get_account	✅	账户详情和点数余额
purchase_credits	✅	创建 Stripe 结账会话以购买更多点数

标记为 ✅ 的工具需要 API 密钥（或 OAuth 令牌）。get_config 和 list_jurisdictions 免费且无需身份验证。

快速开始

选项 A — 托管端点（推荐）

如果你的客户端支持远程 MCP 服务，只需将其指向 https://api.bizverify.co/mcp，并通过 X-API-Key 请求头传入你的密钥（也接受 OAuth 2.1 Bearer 令牌）。

对于仅支持 stdio 的客户端，可使用 mcp-remote 桥接托管端点：

{
  "mcpServers": {
    "bizverify": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.bizverify.co/mcp",
        "--header", "X-API-Key:${BIZVERIFY_API_KEY}"
      ],
      "env": { "BIZVERIFY_API_KEY": "your-api-key" }
    }
  }
}

选项 B — 此桥接程序（从源代码构建）

git clone https://github.com/BizVerify/bizverify-mcp.git
cd bizverify-mcp
npm install
npm run build

然后在客户端中注册该程序（Claude Desktop、Cursor 等）：

{
  "mcpServers": {
    "bizverify": {
      "command": "node",
      "args": ["/absolute/path/to/bizverify-mcp/dist/index.js"],
      "env": { "BIZVERIFY_API_KEY": "your-api-key" }
    }
  }
}

选项 C — Docker

docker build -t bizverify-mcp .
docker run -i --rm -e BIZVERIFY_API_KEY=your-api-key bizverify-mcp

{
  "mcpServers": {
    "bizverify": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "BIZVERIFY_API_KEY", "bizverify-mcp"],
      "env": { "BIZVERIFY_API_KEY": "your-api-key" }
    }
  }
}

配置

环境变量	必需	默认值	说明
BIZVERIFY_API_KEY	用于需要身份验证的工具	–	你的 BizVerify API 密钥，将作为 X-API-Key 发送。无需此密钥即可使用 get_config 和 list_jurisdictions。
BIZVERIFY_MCP_URL	否	https://api.bizverify.co/mcp	覆盖上游 MCP 端点。

获取 API 密钥

几秒钟即可创建——新账户可获得 50 个免费点数：

# 1. Request an access code (sent by email)
curl -X POST https://api.bizverify.co/v1/auth/request-access \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","accept_terms":true}'

# 2. Exchange the 6-digit code for an API key
curl -X POST https://api.bizverify.co/v1/auth/verify-access \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","code":"123456","label":"mcp"}'

完整详情请参阅设置指南和文档。

开发

npm install
npm run build        # compile to dist/
npm run typecheck    # type-check only
npm start            # run the stdio bridge

# Refresh the offline tool snapshot from the live endpoint
node scripts/gen-snapshot.mjs

随附的 src/tools-snapshot.ts 仅用作 tools/list 的离线回退方案（例如，在沙箱容器检查期间）。实时调用始终代理到托管服务。

链接

• 🌐 网站：https://bizverify.co
• 🔌 MCP 设置指南：https://bizverify.co/mcp/
• 📚 文档：https://docs.bizverify.co
• 🧩 Glama 连接器：https://glama.ai/mcp/connectors/co.bizverify/mcp

许可证

MIT © BizVerify