{"_rev":"3-a5a008dbd07c1a7aafb6e7462c6dbca8","time":{"created":"2026-06-01T16:23:35.893Z","modified":"2026-06-01T16:23:36.480Z","0.3.0":"2026-06-01T15:46:44.954Z","0.3.1":"2026-06-01T16:23:36.235Z"},"_id":"@calmessimple/mcp-bling","name":"@calmessimple/mcp-bling","dist-tags":{"latest":"0.3.1"},"versions":{"0.3.1":{"name":"@calmessimple/mcp-bling","version":"0.3.1","description":"MCP server for Bling ERP — orders, products, invoices, stock, AR/AP, webhooks. Fork of @codespar/mcp-bling with additional tools.","type":"module","main":"./dist/index.js","bin":{"mcp-bling":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","start:http":"MCP_HTTP=true node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","express":"^4.21.2"},"devDependencies":{"@types/express":"^5.0.6","@types/node":"^25.5.0","typescript":"^5.8.0","vitest":"^4.1.7"},"license":"MIT","keywords":["mcp","bling","erp","invoices","stock","brazil","sleepCalm"],"mcpName":"io.github.calmessimple/mcp-bling","_id":"@calmessimple/mcp-bling@0.3.1","types":"./dist/index.d.ts","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-c0uQQrs6dseQYlBDjppseHjyES4wCY8vKGg/8hAn221wuxlkYn4dhUAGnKUH25Ppq0/iauqXVO5xzyy5zMrtSA==","shasum":"48c019908df905b6211e49bb7a06e8e49b0b484d","tarball":"https://registry.npmjs.org/@calmessimple/mcp-bling/-/mcp-bling-0.3.1.tgz","fileCount":5,"unpackedSize":48775,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDxCDKCq5J3Fmpnq75rikrB7W6ltzP0LoYyHsnQfedPywIgVpdMr8ZdrNZ/iI5VuNi3FQAmHM6UEgsaqzly54MVzJE="}]},"_npmUser":{"name":"calmessimple","email":"it@calmessimple.com.ar"},"directories":{},"maintainers":[{"name":"calmessimple","email":"it@calmessimple.com.ar"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-bling_0.3.1_1780331016065_0.5704731100428355"},"_hasShrinkwrap":false}},"maintainers":[{"name":"calmessimple","email":"it@calmessimple.com.ar"}],"description":"MCP server for Bling ERP — orders, products, invoices, stock, AR/AP, webhooks. Fork of @codespar/mcp-bling with additional tools.","keywords":["mcp","bling","erp","invoices","stock","brazil","sleepCalm"],"license":"MIT","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-brasil) or [request a tool](https://github.com/codespar/mcp-dev-brasil/issues).\n\n## Links\n\n- [Bling Website](https://bling.com.br)\n- [Bling API Documentation](https://developer.bling.com.br)\n- [MCP Dev Brasil](https://github.com/codespar/mcp-dev-brasil)\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"}