Bulgaria Beneficial Owners

@pipeworx/bulgaria-beneficial-owners

保加利亚法律实体的受益所有人（действителни собственици）， 信息来自登记局（Agentsia po vpisvaniyata）的商业登记册 和非营利法律实体登记册。Fleet #3332，Bruce 针对 #3329 的名称规则裁定。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1875+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关，未获其认可，也非由其发布。

工具

• bg_beneficial_owners(eik) — 根据保加利亚法律实体的 EIK/UIC 查询其受益所有人（9 位统一识别码；外国公司分支机构使用 13 位）。返回每位所有人的姓名、登记册为其注明的国家、登记册有说明时提供的居住国，以及登记册对其控制方式的原文自由文本描述。部分记录属于 AMLD 兜底类别——即在无法确定其他受益所有人时登记的高级管理人员——而不是真正的经济所有人；manner_of_control 会用登记册原文说明具体情况。如果某实体的记录中没有登记自然人所有人（常见于所有权链仅通过其他公司追溯的情况），则返回 found: true、空的所有人列表，以及解释原因的 register_note，绝不会在没有上下文的情况下静默返回空数组。

每次请求都会实时读取——登记局不提供该字段的批量开放数据提取，因此 data_as_of 表示调用当天，而不是镜像刷新日期。

身份验证

无需密钥。读取此字段无需账户、登录或付费——登记册自有的公开搜索工具也以相同方式提供该信息。

个人数据

受益所有人的姓名及国家级别的国籍／居住地信息（绝不包含街道地址）依据 Bruce 的名称规则裁定提供（fleet #3329/#3332，于 2026-10-18/19 实时验证，且无需登录）。共享的移除机制（@pipeworx/shared 的 applyRemovals，与 sos-entities 根据 2026-10-08 名称与角色规则裁定所用的机制相同）会应请求隐藏任何姓名。请联系 [email protected]；每个响应中的 withheld_by_removal_request 会说明该次查询有多少条记录被隐藏。

数据来源

• 登记局（Agentsia po vpisvaniyata）的商业登记册和非营利法律实体登记册——根据保加利亚反洗钱法，每个保加利亚法律实体的受益所有权声明都必须提交至此法定登记册。具体路由仅见于 src/index.ts（CLAUDE.md 第 9b 步）。

关于验证的说明

本工具包的实时获取已通过 curl 验证（200、有真实数据、无需账户）。在这台开发机器上，对同一端点进行普通的 Node fetch() 调用，多次尝试均返回 HTTP 500 和空响应体；而使用 curl 请求完全相同的 URL，每次都成功。这与 WAF/CDN 根据 TLS 客户端指纹进行识别的情况一致，而非身份验证或速率限制拦截（没有 401/403，没有登录重定向，只有一个裸 500）。本工具包实际运行于 Cloudflare Workers 运行时，既不是 curl，也不是 Node，因此在部署后的实时探测确认它属于哪种情况之前，问题仍未解决。如果发现 Workers 也遭到拦截，处理方式与应对任何 WAF 拦截相同：记录情况，不要试图绕过。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "bulgaria-beneficial-owners": {
      "url": "https://gateway.pipeworx.io/bulgaria-beneficial-owners/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/bulgaria-beneficial-owners/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和其余全网关范围的工具。因此，你看到的工具数量会多于表格中的数量：目前，单个工具包端点会列出大约 30 个共享工具，以及该工具包自身的工具。连接的 initialize 响应会说明其确切范围，并且是当天情况的权威答案。

这是有意为之，并非意外的多路复用。元工具让作用域受限的连接也能回答该工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——无需你再添加第二个 MCP 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的架构定义占用的上下文超过路由带来的收益，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的所有工具，而不只是这个工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都会连接到同一个网关和相同的 1875+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/bg_beneficial_owners \
  -H 'Content-Type: application/json' \
  -d '{"eik":"130007884"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/bg_beneficial_owners。查找工具包：使用 {"query":"..."} 执行 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需与网关往返通信：

{
  "mcpServers": {
    "bulgaria-beneficial-owners": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-bulgaria-beneficial-owners"]
    }
  }
}

或者直接运行，确认服务能够启动：

npx -y @pipeworx/mcp-bulgaria-beneficial-owners

它通过 stdin/stdout 使用 MCP 协议，并为仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接额外提供的任何共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由功能。

搭配 ask_pipeworx 使用

你可以用通俗英语提问，而不是直接调用工具——这既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Bulgaria Beneficial Owners data" })

网关会自动选择合适的工具并填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT