Summary
Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.
Guided setup
Connect Bling to Meta Muse in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Bling in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Bling
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Bling, paste the Client ID and Client Secret of your Bling app, click Authorize with Provider and allow access in Bling, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Bling + Meta Muse
Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
BLING_CLIENT_ID, BLING_CLIENT_SECRET
Step 1 — Get credentials
Setting up takes about 10 minutes.
- In Bling open Central de Extensoes, Area do Integrador and click Criar aplicativo. Choose visibility Privado (it then works only with your own Bling account, without Bling's review).
- Fill in the name and contact data. As Link de redirecionamento enter
https://cloud.anythingmcp.com/api/mcp-oauth/callbackon AnythingMCP Cloud, or<your AnythingMCP URL>/api/mcp-oauth/callbackwhen you host AnythingMCP yourself. - Select the scopes this connector needs: products, stock, warehouses, sales orders, contacts, NF-e, accounts receivable and payable, payment methods, statuses and company data. Save. Changing scopes later signs every user out.
- On the tab Informacoes do app copy the Client ID and Client Secret into
BLING_CLIENT_IDandBLING_CLIENT_SECRET, save the connector and click Authorize with Provider, then sign in to Bling and allow access.
Access tokens last 6 hours and are renewed with the refresh token, which lasts 30 days: a connector unused for longer than that needs Authorize with Provider again. Bling blocks an address for an hour after 20 token requests in a minute, so do not retry the sign-in in a loop.
Where to start: bling_get_company checks the connection. Then bling_list_orders (filter by date or status) and bling_get_order, or bling_list_products and bling_get_product.
Products and stock: bling_list_products, bling_get_product, bling_create_product, bling_update_product, bling_list_product_categories, bling_get_stock_balances, bling_get_warehouse_stock_balances, bling_create_stock_movement, bling_list_warehouses. bling_delete_product is installed switched off. saldoVirtual is the physical stock minus what open orders reserve.
Sales orders: bling_list_orders, bling_get_order, bling_create_order, bling_update_order_status. Status ids differ per account: read them with bling_list_status_modules (module Vendas) and bling_list_statuses. bling_delete_order is installed switched off. No tool posts receivables or settles payments.
Contacts: bling_list_contacts, bling_get_contact, bling_create_contact, bling_update_contact (replaces the whole contact: read it first).
NF-e: bling_list_invoices, bling_get_invoice (with DANFE and XML links), bling_generate_invoice_from_order (creates a pending draft only). bling_send_invoice, which transmits the NF-e to SEFAZ, is installed switched off: an authorized NF-e is a tax document. Turn it on only deliberately.
Finance (read-only): bling_list_receivables, bling_get_receivable, bling_list_payables, bling_list_payment_methods. The connector never moves money: no settlement (baixa), boleto or Pix action is included.
Field notes: ids are numbers. Amounts are in BRL with a decimal point. Dates are YYYY-MM-DD; a date range may span at most one year. CPF and CNPJ go as digits. Answers are wrapped in data; errors carry error.type, error.message, error.description and error.fields naming the invalid field.
Paging and limits: lists take pagina from 1 and limite up to 100; an empty data list is the end. Bling allows 3 requests per second and 120,000 per day per account (429 above); 300 errors or 600 requests within 10 seconds block the address for 10 minutes, so do not loop over failing calls.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Muse
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.
- In Muse, open Settings → Connectors and choose Add custom connector.
- Paste the MCP server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse opens the AnythingMCP sign-in page: sign in and approve access.
- In a chat, ask Muse for something that needs the
Blingtools.
You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
bling_get_company | Get the basic data of the Bling account the connector is signed in to: id, nome (company name), cnpj, email and dataContrato. A cheap call… |
bling_list_products | List products: id, idProdutoPai, nome, codigo (SKU), preco, precoCusto, estoque (virtual balance), tipo, situacao, formato, descricaoCurta… |
bling_get_product | Get one product with all details: nome, codigo, preco, tipo, situacao, formato, unidade, gtin, marca, pesos, dimensoes, categoria, estoque… |
bling_create_product | Create a product or service. nome, tipo, situacao and formato are required. Returns data.id of the new product (and of its variations). Tax… |
bling_update_product | Change a product (PATCH: only the fields sent change): name, SKU, price, status, unit, GTIN, brand, short description, weights or category.… |
bling_delete_product | Delete a product permanently. Products used in orders or invoices may be refused; prefer setting situacao I. Installed switched off |
bling_list_product_categories | List product categories: id, descricao and categoriaPai (parent). Up to 100 per page |
bling_get_stock_balances | Get stock balances of products across all warehouses: per product saldoFisicoTotal (physical), saldoVirtualTotal (physical minus reserved… |
bling_get_warehouse_stock_balances | Get stock balances of products in one warehouse (deposito): saldoFisico and saldoVirtual per product |
bling_create_stock_movement | Record a stock movement for a product in a warehouse: E entrada (in), S saida (out) or B balanco (set the balance to the quantity). Returns… |
bling_list_warehouses | List warehouses (depositos): id, descricao, situacao, padrao (default) and desconsiderarSaldo |
bling_list_orders | List sales orders (pedidos de venda): id, numero, numeroLoja (marketplace order number), data, dataSaida, dataPrevista, totalProdutos… |
bling_get_order | Get one sales order: numero, numeroLoja, dates, contato, situacao, loja, itens (produto, codigo, descricao, quantidade, valor, desconto)… |
bling_create_order | Create a sales order. Required: contato (id), data, dataSaida, dataPrevista, itens and parcelas. Returns data.id. Creating the order does… |
bling_update_order_status | Change the status (situacao) of a sales order, for example to Em andamento or Atendido. Valid status ids come from bling_list_statuses for… |
bling_delete_order | Delete a sales order permanently. Cannot be undone. Installed switched off |
bling_list_status_modules | List the Bling modules that have statuses (situacoes): id, nome and descricao, for example Vendas (sales orders). Use the id with… |
bling_list_statuses | List the statuses of one module: id, nome, cor and idHerdado (the standard status it derives from). The ids are what bling_list_orders and… |
bling_list_contacts | List contacts (customers, suppliers and others): id, nome, codigo, situacao, numeroDocumento (CPF or CNPJ), telefone and celular. Search by… |
bling_get_contact | Get one contact: nome, fantasia, tipo (F, J, E), numeroDocumento, ie, email, emailNotaFiscal, telefone, celular, endereco (geral and… |
bling_create_contact | Create a contact (customer or supplier). nome, tipo and situacao are required. Returns data.id |
bling_update_contact | Replace a contact (PUT: the whole contact is rewritten, fields left out may be emptied). Read it first with bling_get_contact, change what… |
bling_list_invoices | List NF-e (electronic invoices): id, tipo (0 entrada, 1 saida), situacao, numero, serie, dataEmissao, dataOperacao, chaveAcesso, contato… |
bling_get_invoice | Get one NF-e: numero, serie, situacao, chaveAcesso, dataEmissao, contato, itens with taxes, transporte, parcelas, valorNota, xml (link)… |
bling_generate_invoice_from_order | Create a pending NF-e draft from a sales order (situacao pendente). It is not sent to SEFAZ: issuing is a separate step done in Bling or… |
bling_send_invoice | Issue an NF-e: transmit it to SEFAZ for authorization. An authorized NF-e is a legal tax document that can only be cancelled within the… |
bling_list_receivables | List accounts receivable (contas a receber): id, situacao, vencimento, valor, saldo, contato, formaPagamento, origem (the order or… |
bling_get_receivable | Get one account receivable: situacao, vencimento, valor, saldo, dataEmissao, contato, formaPagamento, categoria, origem, boleto and Pix… |
bling_list_payables | List accounts payable (contas a pagar): id, situacao, vencimento, valor, contato and origem. Read-only. Up to 100 per page |
bling_list_payment_methods | List payment methods (formas de pagamento): id, descricao, tipoPagamento and situacao. The id goes into the parcelas of an order |
Example prompts
- "Which sales orders from today are still open?"
- "What is the stock of product SKU CAM-PRETA-M in each warehouse?"
- "Create a draft NF-e from sales order 15873."
- "Which receivables are due this week, and for how much in BRL?"
- "Move order 15873 to the status Em andamento."
FAQ
How does it sign in? With your own private Bling app from Central de Extensoes, Area do Integrador: paste its Client ID and Client Secret, then click Authorize with Provider and allow access in Bling. Tokens are renewed on their own.
Can it issue NF-e? It reads NF-e and creates drafts from orders, but bling_send_invoice, which transmits the NF-e to SEFAZ, installs switched off: an authorized NF-e is a tax document. Accounts receivable and payable are read-only.
Which tools install switched off? bling_send_invoice, bling_delete_product and bling_delete_order. Switch them on on the connector page only if the AI should use them.
Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.
Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.
Next steps
Was this guide helpful?