{"_id":"@codespar/mcp-bling","_rev":"6-ab7549f28f56ac7fc95eb3796cc89969","name":"@codespar/mcp-bling","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-bling","version":"0.1.0","keywords":["mcp","bling","erp","invoices","stock","brazil"],"license":"MIT","_id":"@codespar/mcp-bling@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-bling":"dist/index.js"},"dist":{"shasum":"7729efe8abf4fdf6e9218dfa4d0d5f33576793e8","tarball":"https://registry.npmjs.org/@codespar/mcp-bling/-/mcp-bling-0.1.0.tgz","fileCount":5,"integrity":"sha512-AswtZsXb1g+Vw6X5DT3Ywg2rDXCebbvQ7bh9IVAkkVty5+/jp8ltyQmWH/B2RfWc1WS0zF6ZntZOoeLBnbkRvA==","signatures":[{"sig":"MEUCIHKhJ32f+H0sv2/iWPIKBendIqila6oL6+rkLQEHiybWAiEA+mX6dcR6JNWs0QI9fJxxaCwIt9QWhtmfcHN4gjm9nnw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29513},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"2f4996f5df31d6f8bf3a3e606ecc416783ceaf2b","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"10.9.4","description":"MCP server for Bling — ERP, products, orders, invoices, stock management","directories":{},"_nodeVersion":"22.22.1","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bling_0.1.0_1775044086189_0.11864746989396058","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-bling","version":"0.1.2","keywords":["mcp","bling","erp","invoices","stock","brazil"],"license":"MIT","_id":"@codespar/mcp-bling@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-bling":"dist/index.js"},"dist":{"shasum":"e9354625906ab71c00741acb90f01281e41c64c3","tarball":"https://registry.npmjs.org/@codespar/mcp-bling/-/mcp-bling-0.1.2.tgz","fileCount":7,"integrity":"sha512-ot+8GOzkFaUIDNKLlBeu2BcmCJcSGSheUvLEfreP0/1XTvW8DzqRV1tjLefGfz6XOtgxNNKDzCHmbCD3ygH5ow==","signatures":[{"sig":"MEQCICr63yPUccvuAm4YsYcYh2UL/wqceTHmzBzHRM+lxhNlAiA+BpA4lzTXFn/4lIZHsP40Fm6VHpRAAprGYoYy/yLFAw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36640},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-bling","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Bling — ERP, products, orders, invoices, stock management","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bling_0.1.2_1775953705891_0.256959373614009","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-bling","version":"0.2.0","keywords":["mcp","bling","erp","invoices","stock","brazil"],"license":"MIT","_id":"@codespar/mcp-bling@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-bling":"dist/index.js"},"dist":{"shasum":"d0b768e696d430b038d513b51973cece16b6537b","tarball":"https://registry.npmjs.org/@codespar/mcp-bling/-/mcp-bling-0.2.0.tgz","fileCount":7,"integrity":"sha512-cVmVBPAngRR7iCztHPmwcggqG3V8mJiowN0QUDhy3mCs0WGsdWB6dbUGHd6qSRbr9Vrfa29i1OUt4VVs2UlRhg==","signatures":[{"sig":"MEUCICxP07ZKq5NunjiD8A82OOAEfoeDEeDYLX4h6sDtNZCeAiEAw/6whCOkrqPRBug/XiC7xxFf1K1qcwc/Jyz3l+DeY20=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69573},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"bcd94c331d54cfed9e5380cc2d0d8aaee4d0c815","mcpName":"io.github.codespar/mcp-bling","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Bling — ERP, products, orders, purchase orders, invoices (NF-e/NFS-e), stock, AR/AP, warehouses, webhooks","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bling_0.2.0_1777038490850_0.29697651366889244","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-bling","version":"0.2.1","keywords":["mcp","bling","erp","invoices","stock","brazil"],"license":"MIT","_id":"@codespar/mcp-bling@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-bling":"dist/index.js"},"dist":{"shasum":"97590bf3f718ebdde2c68805cf5d0776615440a8","tarball":"https://registry.npmjs.org/@codespar/mcp-bling/-/mcp-bling-0.2.1.tgz","fileCount":7,"integrity":"sha512-8aJ2hoxOITKksiR+1xItEWBmfFBvtn6NaDKxBEsSyyqkkmzgXZUPMDRpBKf+CFtHWiVyfbCr5wvJ5jNTSo2Ibw==","signatures":[{"sig":"MEUCIQD1VXzLsZFUzkqFqqg9EZo8cK76Kuh4zAduY48vQgdsPwIgFyx0eoyl8MiZbsejxYi74sLIG4VZ4XB3+IDW5TNk1tU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":69604},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-bling","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Bling — ERP, products, orders, purchase orders, invoices (NF-e/NFS-e), stock, AR/AP, warehouses, webhooks","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bling_0.2.1_1777123060688_0.19705177923016293","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-bling","version":"0.2.2","description":"MCP server for Bling — ERP, products, orders, purchase orders, invoices (NF-e/NFS-e), stock, AR/AP, warehouses, webhooks","type":"module","main":"./dist/index.js","bin":{"mcp-bling":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","bling","erp","invoices","stock","brazil"],"mcpName":"io.github.codespar/mcp-bling","_id":"@codespar/mcp-bling@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-MJIurpUhBk2z5I1yHm5pK0T0zBPLSOAazpv7O+DB9SWW+SoH4GeeERATrx9ltNALTHLezpjQJzTZOdAKgX1uQQ==","shasum":"d88f601ee10cbea27738d34b67d68e2e41e8ad1f","tarball":"https://registry.npmjs.org/@codespar/mcp-bling/-/mcp-bling-0.2.2.tgz","fileCount":7,"unpackedSize":70846,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD9cyJsnC3AXdyCGeJ/z4Pn46gNzwP1RpxEgK2vBAPpVwIgH0UqYTjA1WFxgOP8VqqLo4XdaxmY8y8JTCLdPuo/pno="}]},"_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-bling_0.2.2_1782153602611_0.3743317977858498"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-01T11:48:06.051Z","modified":"2026-06-22T18:40:02.954Z","0.1.0":"2026-04-01T11:48:06.333Z","0.1.2":"2026-04-12T00:28:26.049Z","0.2.0":"2026-04-24T13:48:10.995Z","0.2.1":"2026-04-25T13:17:40.853Z","0.2.2":"2026-06-22T18:40:02.788Z"},"license":"MIT","keywords":["mcp","bling","erp","invoices","stock","brazil"],"description":"MCP server for Bling — ERP, products, orders, purchase orders, invoices (NF-e/NFS-e), stock, AR/AP, warehouses, webhooks","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-bling\n\n> MCP server for **Bling** — ERP with products, orders, contacts, invoices, and stock management\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-bling)](https://www.npmjs.com/package/@codespar/mcp-bling)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bling\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-bling\"],\n      \"env\": {\n        \"BLING_ACCESS_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add bling -- npx @codespar/mcp-bling\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"bling\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-bling\"],\n      \"env\": {\n        \"BLING_ACCESS_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n## Tools (28)\n\n| Tool | Purpose |\n|---|---|\n| `list_products` | List products in Bling |\n| `create_product` | Create a product in Bling |\n| `list_categories` | List product categories in Bling |\n| `create_category` | Create a product category in Bling |\n| `list_orders` | List sales orders in Bling |\n| `create_order` | Create a sales order in Bling |\n| `list_purchase_orders` | List purchase orders (pedidos de compras) in Bling |\n| `create_purchase_order` | Create a purchase order (pedido de compra) in Bling |\n| `list_contacts` | List contacts (customers/suppliers) in Bling |\n| `create_contact` | Create a contact in Bling |\n| `get_contact` | Get a single contact by ID |\n| `update_contact` | Update an existing contact |\n| `list_invoices` | List fiscal invoices (NF-e) in Bling |\n| `create_invoice` | Create a fiscal invoice (NF-e) from an order |\n| `send_invoice` | Send/emit an already-created NF-e to SEFAZ |\n| `create_service_invoice` | Create a service invoice (NFS-e) in Bling |\n| `get_stock` | Get stock/inventory for a product |\n| `update_stock` | Update stock for a product at a warehouse |\n| `create_stock_movement` | Register a stock-in or stock-out movement for a product (alias of update_stock with explicit direction) |\n| `list_warehouses` | List warehouses (depósitos) in Bling |\n| `create_warehouse` | Create a warehouse (depósito) in Bling |\n| `list_accounts_receivable` | List accounts receivable (contas a receber) |\n| `create_account_receivable` | Create an account receivable (conta a receber) |\n| `list_accounts_payable` | List accounts payable (contas a pagar) |\n| `create_account_payable` | Create an account payable (conta a pagar) |\n| `list_payment_methods` | List payment methods (formas de pagamento) |\n| `subscribe_webhook` | Register a webhook (notificação) to receive Bling events |\n| `unsubscribe_webhook` | Remove a previously registered webhook |\n\n## Authentication\n\nBling uses OAuth2 Bearer tokens for authentication.\n\n## Sandbox / Testing\n\nBling provides a sandbox via the OAuth flow. Use test credentials for development.\n\n### Get your credentials\n\n1. Go to [Bling Developer Portal](https://developer.bling.com.br)\n2. Create an account\n3. Register an OAuth application and obtain an access token\n4. Set the `BLING_ACCESS_TOKEN` environment variable\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `BLING_ACCESS_TOKEN` | Yes | OAuth2 access token |\n\n## Roadmap\n\n### v0.3 (planned)\n- `production_management` — Manage production orders\n- `multi_store` — Multi-store inventory (Mercado Livre, Shopee, Amazon integrations)\n- `list_nfce` / `create_nfce` — Consumer invoice (NFC-e) helpers\n- Richer filters on `list_accounts_*` (by payment status, contact)\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [Bling Website](https://bling.com.br)\n- [Bling API Documentation](https://developer.bling.com.br)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\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"}