Operate your workspace programmatically.

Two surfaces, one workspace. Hit the REST API directly when you need raw CRUD, or wire the MCP server to Claude so it can act on your data without leaving the chat. Both share the same scoped API keys.

1. 1

   Create an API key

   Open Settings → API keys, pick a name (e.g. "MCP server"), select the scopes you want to grant, and copy the bpk_live_… secret. It's shown exactly once.

2. 2

   Smoke-test the API

   Hit /api/v1/me with your key to verify the tenant + scopes.

   curl https://binpocket.com/api/v1/me \
     -H "Authorization: Bearer bpk_live_<YOUR_KEY>"

3. 3

   Wire the MCP server

   No git, no npm install. Download the single-file bundle from binpocket.com and register it with Claude Code.

   # Zero-install path — single file, no git, no npm
   curl -O https://binpocket.com/mcp/binpocket-mcp.js
   BINPOCKET_API_KEY=bpk_live_xxx \
     claude mcp add binpocket -- node $(pwd)/binpocket-mcp.js

   Want to use a different AI? Fetch the prompt pack and paste it into the chat.

   # Or: feed any AI the prompt pack
   curl https://binpocket.com/mcp/context.md

Every request must include a Bearer token in the Authorization header.

Authorization: Bearer bpk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

• Keys are issued as bpk_live_<32 hex chars>. 41 chars total.
• Only the SHA-256 hash is stored. The raw value can never be retrieved.
• Each request bumps lastUsedAt — useful to spot stale keys.
• Revoke instantly from /settings/integrations/api-keys. Revoked keys return 401 key_revoked.

Each key carries one or more scopes. A scope unlocks a single permission on a single resource — never more. Combine multiple scopes on the same key when needed.

All endpoints live under /api/v1 and return JSON. Money is integer cents. Currencies are ISO 4217. Dates are ISO 8601.

The MCP server wraps every REST endpoint as a typed tool. Configure it once, then ask Claude to operate your workspace in natural language.

Available tools

Register with Claude Code

BINPOCKET_API_KEY=bpk_live_xxx claude mcp add binpocket \
  -- node /abs/path/to/Binpocket/mcp/dist/index.js

Claude Desktop

Add the following block to your claude_desktop_config.json.

{
  "mcpServers": {
    "binpocket": {
      "command": "node",
      "args": ["/abs/path/to/Binpocket/mcp/dist/index.js"],
      "env": {
        "BINPOCKET_URL": "https://binpocket.com",
        "BINPOCKET_API_KEY": "bpk_live_..."
      }
    }
  }
}

List products by SKU

curl https://binpocket.com/api/v1/products?q=AF-60 \
  -H "Authorization: Bearer bpk_live_xxx"

Create a customer

curl -X POST https://binpocket.com/api/v1/customers \
  -H "Authorization: Bearer bpk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ACME SARL",
    "email": "[email protected]",
    "country": "FR",
    "currency": "EUR",
    "taxRate": 20
  }'

Create a sales order with per-unit Nayax codes

curl -X POST https://binpocket.com/api/v1/sales \
  -H "Authorization: Bearer bpk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cmo5rgtdn002pjs04sjj8znbd",
    "currency": "EUR",
    "taxRate": 20,
    "lines": [{
      "productId": "cmo5rgtdn0042js04sjj8znbe",
      "qty": 4,
      "unitPriceCents": 12000,
      "nayaxCodes": ["AF-60-01", "AF-60-02", "AF-60-03", "AF-60-04"]
    }]
  }'

Ask Poppy

curl -X POST https://binpocket.com/api/v1/poppy/ask \
  -H "Authorization: Bearer bpk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "question": "Which customer drove the most margin this quarter?" }'

Can I use the API without the MCP server?

Yes. The REST API is independent — curl, fetch, requests, anything that speaks HTTPS.

Is there a rate limit?

Per-tenant fair-use limits apply. Hard limits will be published before they're enforced.

Can the MCP server run remotely?

Yes. It only needs network access to your Binpocket URL and the API key. Run it on any machine that hosts your MCP-aware LLM.

How do I rotate a key?

Issue a new key, swap it in the consuming client, then revoke the old one. The two keys can coexist during the swap.