Mcp Pluggy

io.github.codespar由 GitHub 账号 codespar 发布v0.1.2更新于 Oct 24, 2026

MCP server for Pluggy — Open Finance Brasil aggregator: accounts, transactions, payment initiation

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

让助手通过 Pluggy 查询巴西开放金融数据：银行连接、账户、交易、身份信息以及支付意图。

可以做什么
将 Pluggy 巴西开放金融聚合 API 封装为 16 个工具。可列出连接器与交易分类，创建和管理银行连接（items），并读取账户、交易和身份数据。还可创建 Pluggy Connect 令牌，并发起或查询支付意图。
适用场景
当助手需要巴西银行账户、交易或身份数据，或需要发起通过 Pluggy 处理的支付流程时使用。生产凭据使用前，可用带合成数据的沙箱连接器进行测试。
运行要求
通过 stdio 在本地运行，通常使用 npx @codespar/mcp-pluggy，因此需要 Node.js。需要 Pluggy 账户以及 PLUGGY_CLIENT_ID 和 PLUGGY_CLIENT_SECRET 环境变量；PLUGGY_API_BASE 可覆盖默认 API 地址。需要访问 Pluggy API 的网络连接。
安装前请注意
PLUGGY_CLIENT_ID 和 PLUGGY_CLIENT_SECRET 是可访问金融数据的密钥，不应放入共享配置。工具可创建、更新和删除银行连接，并可创建可能转移资金的支付意图。身份数据包含法定姓名、证件和地址，账户与交易数据会发送给 Pluggy。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Pluggy，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-pluggy

MCP server for Pluggy — Open Finance Brasil aggregator (ITP/TPP). Pluggy holds the ICP-Brasil certificate and runs Dynamic Client Registration with each Brazilian bank, so you integrate against one API instead of N.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "pluggy": {      "command": "npx",      "args": ["@codespar/mcp-pluggy"],      "env": {        "PLUGGY_CLIENT_ID": "your-client-id",        "PLUGGY_CLIENT_SECRET": "your-client-secret"      }    }  }}

Cursor / VS Code

Same config in .cursor/mcp.json or VS Code's MCP integration.

Tools (16)

Connectors + categories

ToolPluggy endpointNotes
list_connectorsGET /connectorsFilter by name / types / countries / sandbox
get_connectorGET /connectors/{id}Single connector definition
list_categoriesGET /categoriesTransaction categorization taxonomy

Connect token

ToolPluggy endpointNotes
create_connect_tokenPOST /connect_tokenEmbed Pluggy Connect widget on the client

Items (bank connections)

ToolPluggy endpointNotes
create_itemPOST /itemsNew bank connection from credentials
list_itemsGET /itemsLists existing connections
get_itemGET /items/{id}Single connection
update_itemPATCH /items/{id}Refresh credentials / trigger sync
delete_itemDELETE /items/{id}Revoke connection

Accounts + transactions + identity

ToolPluggy endpointNotes
list_accountsGET /accounts?itemId=...Checking / savings / credit / investment
get_accountGET /accounts/{id}Single account
list_transactionsGET /transactions?accountId=...Date-range filter
get_transactionGET /transactions/{id}Single transaction
list_identitiesGET /identity?itemId=...Legal name + document + address

Payments (PISP)

ToolPluggy endpointNotes
create_payment_intentPOST /payments/intentsInitiate a Pluggy Payments intent
get_payment_intentGET /payments/intents/{id}Poll status

Authentication

Pluggy uses an OAuth2 client-credentials flow:

  1. Client obtains an API key by POST /auth with clientId + clientSecret
  2. Subsequent requests include the API key as X-API-KEY

Issue credentials at the Pluggy dashboard:

Sandbox / Testing

Pluggy provides sandbox connectors with synthetic accounts and transactions. The sandbox uses the same API endpoint (https://api.pluggy.ai); the connector list returned by /connectors includes sandbox banks (Pluggy Bank, BR · Pluggy Bank).

Environment Variables

VariableRequiredDescription
PLUGGY_CLIENT_IDyesClient ID from the Pluggy dashboard
PLUGGY_CLIENT_SECRETyesClient secret from the Pluggy dashboard
PLUGGY_API_BASEnoOverride API base (default https://api.pluggy.ai)

Why use Pluggy via CodeSpar

If you only need the MCP server, install the package directly. If you're building a commerce agent that needs Pluggy + Pix + NF-e + WhatsApp + dashboard governance, look at the managed tier.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

来源：packages/banking/pluggy/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分