Skip to main content
BL

Bling

v0.2.2OAuth2

ERP with inventory, orders, NF-e emission, and marketplace integrations. Connects to Mercado Livre, Shopee, and Amazon.

39 tools1 env varsπŸ‡§πŸ‡· Brazilstable on npm

What your agent can do

Bling gives your agent 39 tools it calls directly β€” pick the ones it needs, in Claude, Cursor, or any MCP client.

  • list_products β€” List products in Bling
  • get_product β€” Get full details of a product by ID, including variations, stock info, dimensions, pricing, and supplier data
  • create_product β€” Create a product in Bling
Example call
// Your agent calls a tool directly β€” no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("list_products", { /* ... */ });

Install

terminal
$ npm install @codespar/mcp-bling

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "bling": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-bling"
      ],
      "env": {
        "BLING_ACCESS_TOKEN": "<your_bling_access_token>"
      }
    }
  }
}

After restart, your agent can call any of the 39 tools below β€” try list_products first.

Environment variables Β· 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

BLING_ACCESS_TOKEN
requiredsecret

API key for bling

Available tools Β· 39

Each tool is independent β€” your agent loads only what it needs to reduce context and response time.

READlist_products
List products in Bling
READget_product
Get full details of a product by ID, including variations, stock info, dimensions, pricing, and supplier data
WRITEcreate_product
Create a product in Bling
READlist_categories
List product categories in Bling
WRITEcreate_category
Create a product category in Bling
READlist_orders_with_items
Fetch sales orders with full line items (SKUs, qty, prices) for a date range, one summary page (up to 100 orders) at a time. Check hasMore and call again with nextPage until hasMore=false.
READlist_orders
List sales orders in Bling
READget_order
Get a single sales order by ID, including full line items (products, SKUs, quantities, prices)

Compatible frameworks

MCP is a protocol β€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

Run `npx -y @codespar/mcp-bling` and add the config block above to your MCP client β€” Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Bling β€” MCP server Β· 39 tools | CodeSpar