{"_id":"@codespar/mcp-pluggy","_rev":"4-c09fee456bdfea75d64d4aca80584628","name":"@codespar/mcp-pluggy","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-pluggy","version":"0.1.0","keywords":["mcp","pluggy","open-finance","brazil","banking","aggregator","ofb","tpp"],"license":"MIT","_id":"@codespar/mcp-pluggy@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-pluggy":"dist/index.js"},"dist":{"shasum":"0d4a0952312d297facf92a7127ce4011d18c5425","tarball":"https://registry.npmjs.org/@codespar/mcp-pluggy/-/mcp-pluggy-0.1.0.tgz","fileCount":6,"integrity":"sha512-18x1pOsuCUi0lBhvSG7RHkz2KaluP9ngC1BmCGINsKVwcq2ow3g2Lw+1uG5cpmVBJRSR4VzH+a97LtJH2lYC3w==","signatures":[{"sig":"MEUCIQDUIqKy6oNW0Dn+59eEWpHwmU80uQwoJ2M9SiqzHemKrwIgSP6vFubq8fH4i6ttAgBgn0fz+c1hr8MCtreNcj+vKto=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25092},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"01c9d71073550580f8ed2e684fe57010e8b68010","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Pluggy — Open Finance Brasil aggregator (ITP/TPP)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-pluggy_0.1.0_1778718060545_0.06446041301758876","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@codespar/mcp-pluggy","version":"0.1.1","keywords":["mcp","pluggy","open-finance","brazil","banking","aggregator","ofb","tpp"],"license":"MIT","_id":"@codespar/mcp-pluggy@0.1.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"bin":{"mcp-pluggy":"dist/index.js"},"dist":{"shasum":"a63efc8939676c7c09ea4ae62bdc568b9cdd8e21","tarball":"https://registry.npmjs.org/@codespar/mcp-pluggy/-/mcp-pluggy-0.1.1.tgz","fileCount":6,"integrity":"sha512-AawpoOQIuemqWkqVljDaVknID0nJGlBjcl4A6zC1J54fOGZH7PlwFqskH3SJK922lqrumUELrsvaCqUeH3HoTw==","signatures":[{"sig":"MEQCIEeHaBWYdUJm37yoaIJbgYNDMhSxBQ3iFvk3pnlky+9EAiB1K0Cbu/7zdD9S3e04V45V6LjeEDCU/E0HwqG6UZEEZw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25138},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"a121ea567035fa095d42b603f244273e3a34cc90","mcpName":"io.github.codespar/mcp-pluggy","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.8","description":"MCP server for Pluggy — Open Finance Brasil aggregator (ITP/TPP)","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-pluggy_0.1.1_1781995339032_0.45723237108081904","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-pluggy","version":"0.1.2","description":"MCP server for Pluggy — Open Finance Brasil aggregator (ITP/TPP)","type":"module","main":"dist/index.js","bin":{"mcp-pluggy":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","pluggy","open-finance","brazil","banking","aggregator","ofb","tpp"],"mcpName":"io.github.codespar/mcp-pluggy","_id":"@codespar/mcp-pluggy@0.1.2","gitHead":"8e115a5cb8aed75e812af698b03aa996ccd8d7c1","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-HuZn5HrEKcDX/Q0v71nLJykYnXxx1YAaH6Z5EWKWpMPSK5bEV8SHn/r4wJ5fV2pAYuVTDKXv9FYpBg5u3bo1Fg==","shasum":"27819f9a3ca0c6e4c191e245a70889864ab20b94","tarball":"https://registry.npmjs.org/@codespar/mcp-pluggy/-/mcp-pluggy-0.1.2.tgz","fileCount":6,"unpackedSize":25723,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDFE/VoP/vhGa1OsHoCARsHJes2y1olf37BHyWSnFjhWAiAPtVvB3d//Tnm93gSo1s1DDzBrtkyyrv+dJ2nCQt+B8g=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-pluggy_0.1.2_1782158082214_0.08138703002474257"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-14T00:21:00.444Z","modified":"2026-06-22T19:54:42.474Z","0.1.0":"2026-05-14T00:21:00.678Z","0.1.1":"2026-06-20T22:42:19.168Z","0.1.2":"2026-06-22T19:54:42.338Z"},"license":"MIT","keywords":["mcp","pluggy","open-finance","brazil","banking","aggregator","ofb","tpp"],"description":"MCP server for Pluggy — Open Finance Brasil aggregator (ITP/TPP)","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-pluggy\n\nMCP 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.\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"pluggy\": {\n      \"command\": \"npx\",\n      \"args\": [\"@codespar/mcp-pluggy\"],\n      \"env\": {\n        \"PLUGGY_CLIENT_ID\": \"your-client-id\",\n        \"PLUGGY_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / VS Code\n\nSame config in `.cursor/mcp.json` or VS Code's MCP integration.\n\n## Tools (16)\n\n### Connectors + categories\n\n| Tool | Pluggy endpoint | Notes |\n|---|---|---|\n| `list_connectors` | `GET /connectors` | Filter by name / types / countries / sandbox |\n| `get_connector` | `GET /connectors/{id}` | Single connector definition |\n| `list_categories` | `GET /categories` | Transaction categorization taxonomy |\n\n### Connect token\n\n| Tool | Pluggy endpoint | Notes |\n|---|---|---|\n| `create_connect_token` | `POST /connect_token` | Embed Pluggy Connect widget on the client |\n\n### Items (bank connections)\n\n| Tool | Pluggy endpoint | Notes |\n|---|---|---|\n| `create_item` | `POST /items` | New bank connection from credentials |\n| `list_items` | `GET /items` | Lists existing connections |\n| `get_item` | `GET /items/{id}` | Single connection |\n| `update_item` | `PATCH /items/{id}` | Refresh credentials / trigger sync |\n| `delete_item` | `DELETE /items/{id}` | Revoke connection |\n\n### Accounts + transactions + identity\n\n| Tool | Pluggy endpoint | Notes |\n|---|---|---|\n| `list_accounts` | `GET /accounts?itemId=...` | Checking / savings / credit / investment |\n| `get_account` | `GET /accounts/{id}` | Single account |\n| `list_transactions` | `GET /transactions?accountId=...` | Date-range filter |\n| `get_transaction` | `GET /transactions/{id}` | Single transaction |\n| `list_identities` | `GET /identity?itemId=...` | Legal name + document + address |\n\n### Payments (PISP)\n\n| Tool | Pluggy endpoint | Notes |\n|---|---|---|\n| `create_payment_intent` | `POST /payments/intents` | Initiate a Pluggy Payments intent |\n| `get_payment_intent` | `GET /payments/intents/{id}` | Poll status |\n\n## Authentication\n\nPluggy uses an OAuth2 client-credentials flow:\n\n1. Client obtains an API key by `POST /auth` with `clientId` + `clientSecret`\n2. Subsequent requests include the API key as `X-API-KEY`\n\nIssue credentials at the Pluggy dashboard:\n\n- Production: <https://dashboard.pluggy.ai>\n- Docs: <https://docs.pluggy.ai>\n\n## Sandbox / Testing\n\nPluggy 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`).\n\n## Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `PLUGGY_CLIENT_ID` | yes | Client ID from the Pluggy dashboard |\n| `PLUGGY_CLIENT_SECRET` | yes | Client secret from the Pluggy dashboard |\n| `PLUGGY_API_BASE` | no | Override API base (default `https://api.pluggy.ai`) |\n\n## Why use Pluggy via CodeSpar\n\nIf 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.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}