Fin Codes API

Fin Codes API MCP 服务

将 AI 助手连接到银行参考数据、收款人姓名验证和制裁筛查。

托管端点： https://mcp.fincodesapi.com/mcp

传输方式： Streamable HTTP

主页和设置： https://fincodesapi.com/mcp-server

官方注册表： com.fincodesapi/fincodesapi

此代码库包含托管服务的公开连接器配置和文档，不包含专有后端，不运行本地服务，也不发布 npm、PyPI 或 Docker 软件包。

连接

在客户端中将该端点添加为远程 HTTP MCP 服务，然后通过 OAuth 登录 Fin Codes API 帐户。如有需要，请前往 https://fincodesapi.com/sign-up 注册。支持 OAuth 的客户端无需手动创建 API 密钥。

Claude Code

claude mcp add --transport http fincodesapi https://mcp.fincodesapi.com/mcp

运行 /mcp 登录。在 Claude Desktop 或 claude.ai 中，将该端点添加为自定义连接器。

VS Code

将以下内容添加到 .vscode/mcp.json，然后启动服务并登录：

{"servers":{"fincodesapi":{"type":"http","url":"https://mcp.fincodesapi.com/mcp"}}}

Cursor 和其他 MCP 客户端

在客户端的 MCP 设置中添加远程端点。附带的 mcp.json 定义了连接；plugin.json 是可移植的 Agent Plugins 清单。客户端支持情况和 OAuth 设置方式各不相同。

Cline

在 Cline 中，打开 MCP Servers → Remote Servers，添加上述端点，并选择 Streamable HTTP。按提示完成 OAuth 授权。如果使用 JSON 配置，请采用 Cline 的传输方式拼写：

{"mcpServers":{"fincodesapi":{"type":"streamableHttp","url":"https://mcp.fincodesapi.com/mcp","disabled":false,"autoApprove":[]}}}

如果你的客户端版本不支持 OAuth，可在 https://fincodesapi.com/api-keys 创建自己的 API 令牌，并在本地添加 Authorization: Bearer YOUR_API_KEY 标头。不要将密钥放入共享文件。确认显示了 11 个工具，然后尝试查询 BSB 082-024。

请参阅 Cline 的 MCP 文档。尚未对 Cline 安装此连接器进行独立测试。

Gemini CLI

gemini extensions install https://github.com/swiftcodesapi/fincodesapi-mcp

如果系统提示登录，请运行 /mcp auth fincodesapi。此扩展使用 HTTP 传输和 OAuth 发现机制。

API 密钥客户端

不支持 OAuth 的客户端可以使用在 https://fincodesapi.com/api-keys 创建的 API 密钥。向同一端点发送 Authorization: Bearer YOUR_API_KEY。请将真实密钥保存在客户端的密钥存储中；切勿将其提交到此代码库。

11 个工具

工具	用途
lookup_iban	验证 IBAN，并返回银行、国家/地区和 BIC/SWIFT 详细信息
verify_iban_payee	将提供的收款人姓名与受支持的欧洲 IBAN 持有人进行比对
lookup_bic	查询 BIC/SWIFT 银行和分行详细信息
lookup_us_routing_number	查询美国 ABA 路由号码
lookup_canada_routing_number	查询加拿大路由号码
lookup_australia_bsb	查询澳大利亚 BSB
lookup_new_zealand_bank_code	查询新西兰银行和分行代码
lookup_india_ifsc	查询印度 IFSC
lookup_mexico_clabe	验证墨西哥 CLABE 并识别其银行
lookup_argentina_cbu	验证阿根廷 CBU 并识别其银行
screen_sanctions	根据欧盟、英国、联合国、OFAC、瑞士、澳大利亚和加拿大制裁名单筛查姓名

实时 MCP 工具架构具有权威性。

示例

• “验证 DE57 1001 0010 0593 9081 19，并告诉我其银行和 BIC。”
• “澳大利亚 BSB 082-024 对应哪家银行和哪个分行？”
• “运行文档中注明的免费收款人验证测试用例：DE75512108001245126199 是否与 John Doe 匹配？”
• “以最低匹配分数 95 筛查姓名 Sadam Husein。”

John Doe/IBAN 组合是文档中注明的测试用例。其响应不能证明真实账户的所有权。银行代码有效并不能证明账户存在或归属。制裁姓名相似度需要人工审核，不能证明身份或受制裁状态。这些工具不会转账、执行交易、通过姓名反向搜索私人账户或判定信用状况。

账户与定价

需要 Fin Codes API 账户。查询会消耗账户套餐额度；收款人核验会消耗预付的收款人核验额度。套餐和额度可在 https://fincodesapi.com/pricing 购买。本连接器不处理购买或付款。当前提供试用；具体条款和限制请查看网站。

隐私与支持

输入内容会发送至托管的 Fin Codes API 服务。使用前请查看 https://fincodesapi.com/privacy-policy、https://fincodesapi.com/gdpr 和 https://fincodesapi.com/terms-of-service。支持：[email protected]，或通过 https://fincodesapi.com/mcp-server 联系我们。

许可证

本仓库中的连接器配置和文档采用 MIT 许可证。托管服务仍受其服务条款约束。