Esma Firds

@pipeworx/esma-firds

ESMA 的欧盟统一金融工具参考数据系统（FIRDS）以及 MiFID II 投资公司授权登记册（联盟登记册）——将 ISIN 解析为发行方 LEI、CFI 代码及其上市的所有欧盟交易场所；按发行方搜索工具；并核查公司是否获准在欧盟提供投资服务。无需密钥，每次查询均实时访问 ESMA 自有的公共 Solr 端点。

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

工具

• firds_lookup(isin) — 将一个 ISIN 解析为完整名称、简称、CFI 代码、发行方 LEI、计价货币、债券字段（到期日、面值、固定利率）或适用时的衍生品字段（标的 ISIN、到期日、期权类型），以及其进行交易的所有欧盟交易场所（MIC），并列出各场所的状态和首次／终止交易日期。
• firds_search_by_issuer(issuer_lei?, issuer_name?, limit?) — 查询 FIRDS 中某个发行方的所有工具，可按 LEI（精确匹配）或名称搜索（所有词均须出现，顺序不限）。
• esma_check_firm_authorisation(name?, lei?, limit?) — 在 ESMA 的投资公司联盟登记册中查询公司：授权状态、主管机构、母成员国、实体类型。

身份验证

无需密钥。

数据源

• GET https://registers.esma.europa.eu/solr/esma_registers_firds/select — FIRDS Solr 核心：每个（ISIN，交易场所）组合对应一条文档。为 firds_lookup 和 firds_search_by_issuer 提供数据。
• GET https://registers.esma.europa.eu/solr/esma_registers_upreg/select — 联盟登记册（MiFID II 公司授权）Solr 核心，包含 entity_type:ae 文档。为 esma_check_firm_authorisation 提供数据。

这两个核心均为 ESMA 自行运行的同一个公开、无需密钥的 Solr 实例，位于 registers.esma.europa.eu 上 FIRDS／登记册界面的后端——已于 2026-09-23 确认在线。本工具包会按请求访问该实例；不会导入 ESMA 的 FIRDS 全量／增量 XML 文件（参见“注意事项”）。

特殊说明

• 这是代理，而非镜像，且是有意为之。 ESMA 也会将 FIRDS 作为可下载的完整／增量 XML 文件发布，而对此工具包进行简单构建会将这些文件导入并在本地建立索引。这属于再分发，根据 Bruce 的 fleet #1389 裁定，需要获得再利用授权。上面的 Solr 端点可按查询提供相同的参考数据，无需密钥，因此此工具包选择实时调用——从未下载或存储过任何批量文件。
• 一个 ISIN 对应多行。 FIRDS 会为每个交易场所分别生成一条记录，因此，一只上市场所众多的股票（例如 SAP SE，DE0007164600）会返回约 90 行。firds_lookup 始终会在查询中添加 AND latest_received_flag:1，以获取每个场所的当前状态，而不是 FIRDS 的完整变更日志历史——省略此标记会在不显眼的情况下，将过时／已取代的行与当前行混在一起。随后，它会选取 mic == rca_mic 的记录（ESMA 自身视为参考市场的场所）来获取描述性字段（名称、CFI 代码、货币、LEI）；如果没有，则回退到第一条未终止（status 不是 TERM／CANC）的记录，并将所有记录汇总到 venues 列表中。
• 名称字段是未经分词的字符串，不是全文字段。 gnr_full_name（FIRDS）和 ae_entityName（Union Register）都将整个名称存为一个字符串值——通配符只能匹配该值的开头，因此 Deutsche* AND Bank* 不会匹配任何内容（没有值会同时以两个不同前缀开头）。firds_search_by_issuer 的 issuer_name 和 esma_check_firm_authorisation 的 name 则会先按空白字符拆分输入，再为每个词添加一个 *word* 子串条件并用 AND 连接，这样无论顺序如何，都能正确要求每个词出现在值中的某处。匹配不区分大小写（已验证：sap* 和 SAP* 返回相同结果集）。
• mrkt_trdng_trmination_date——FIRDS 自身的字段名漏了字母“e”（并非这里引入的拼写错误）；因其是 Solr 中的字面字段名，故保持原样。
• Union Register 的核心名称是 esma_registers_upreg（Union Register），并非显而易见的“mifid”或“entities”——由于 ESMA 未提供核心名称列表，因此通过对 /solr/<core>/select 穷举可能的核心名称找到。相邻核心 esma_registers_fitrs_equities（MiFIR 透明度／流动性数据——ADT、LIS 阈值）也位于同一主机上，可能适合未来添加，但不在此处的范围内。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/esma-firds/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 都连接到同一网关和相同的 1879+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

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

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

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

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账户，也无需经过网关往返：

{
  "mcpServers": {
    "esma-firds": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-esma-firds"]
    }
  }
}

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-esma-firds

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Esma Firds data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT