Niubiz

What your agent can do

Niubiz gives your agent 4 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →get_security_token — Fetch the Niubiz API bearer token (POST /api.security/v1/security, Basic auth). Other tools fetch and cache this automatically — call it explicitly only to verify credentials or force a refresh.
• →create_session_token — Create a checkout session (POST /api.ecommerce/v2/ecommerce/token/session/{merchantId}). Returns the sessionKey the Niubiz checkout form needs. Send the purchase amount and the customer's IP for antifraud scoring.
• →authorize_transaction — Authorize a purchase (POST /api.authorization/v3/authorization/ecommerce/{merchantId}). Pass the transactionToken the Niubiz checkout form returned after the customer entered the card, plus your purchaseNumber and the amount.

// 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("get_security_token", { /* ... */ });

Install

$ npm install @codespar/mcp-niubiz

Quickstart

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

{
  "mcpServers": {
    "niubiz": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-niubiz"
      ],
      "env": {
        "NIUBIZ_USER": "<your_niubiz_user>",
        "NIUBIZ_PASSWORD": "<your_niubiz_password>",
        "NIUBIZ_MERCHANT_ID": "<your_niubiz_merchant_id>"
      }
    }
  }
}

After restart, your agent can call any of the 4 tools below — try get_security_token first.

Environment variables · 4

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

Available tools · 4

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

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions