{"_id":"@b4bit/b4bit-pay-mcp","name":"@b4bit/b4bit-pay-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@b4bit/b4bit-pay-mcp","version":"0.1.0","description":"MCP server for B4bit Pay — probe the API, verify webhooks, search docs from any Claude client.","type":"module","license":"MIT","bin":{"b4bit-pay-mcp":"dist/index.js","b4bit-pay-install-skill":"dist/install-skill.js"},"scripts":{"build":"tsc","dev":"tsx watch src/index.ts","start":"node dist/index.js","test":"vitest run","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.20.0","undici":"^7.2.0","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.10.0","tsx":"^4.19.0","typescript":"^5.7.0","vitest":"^2.1.0"},"engines":{"node":">=20.11"},"keywords":["mcp","model-context-protocol","b4bit","b4bit-pay","payments","cryptocurrency","ai-agents","claude"],"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/B4bit-Official/b4bit-pay-mcp.git"},"homepage":"https://github.com/B4bit-Official/b4bit-pay-mcp#readme","bugs":{"url":"https://github.com/B4bit-Official/b4bit-pay-mcp/issues"},"author":{"name":"B4bit","email":"support@b4bit.com"},"_id":"@b4bit/b4bit-pay-mcp@0.1.0","gitHead":"4a9079351819b79154518a12b02ef9f5363fc3a3","_nodeVersion":"22.21.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-KvrJFmXK0WnFjFV8O9iz3wWqeVk6aPUdJxAnWlFOZZjipHEJhX2woOn2GNHjDCU4gH1GF1B68DdtsJvi+igcfw==","shasum":"f731a3c986e2f55cbd3f123c11e1a93a368b2fa6","tarball":"https://registry.npmjs.org/@b4bit/b4bit-pay-mcp/-/b4bit-pay-mcp-0.1.0.tgz","fileCount":27,"unpackedSize":95003,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDkrL29hp9+Up9OMvtp8aip/OighUO3eIxV19/ND6pJDwIhAMBNzHC0Y3ltdLwn+LGgDZj0ipWhEglmHRHgJO4McfVZ"}]},"_npmUser":{"name":"b4bitdev","email":"it@b4bit.com"},"directories":{},"maintainers":[{"name":"b4bitdev","email":"it@b4bit.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/b4bit-pay-mcp_0.1.0_1776433890149_0.7683912425836446"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-17T13:51:29.994Z","0.1.0":"2026-04-17T13:51:30.300Z","modified":"2026-04-17T13:51:30.536Z"},"maintainers":[{"name":"b4bitdev","email":"it@b4bit.com"}],"description":"MCP server for B4bit Pay — probe the API, verify webhooks, search docs from any Claude client.","homepage":"https://github.com/B4bit-Official/b4bit-pay-mcp#readme","keywords":["mcp","model-context-protocol","b4bit","b4bit-pay","payments","cryptocurrency","ai-agents","claude"],"repository":{"type":"git","url":"git+https://github.com/B4bit-Official/b4bit-pay-mcp.git"},"author":{"name":"B4bit","email":"support@b4bit.com"},"bugs":{"url":"https://github.com/B4bit-Official/b4bit-pay-mcp/issues"},"license":"MIT","readme":"# @b4bit/b4bit-pay-mcp\n\nMCP server for **B4bit Pay**. Use from any MCP-compatible client (Claude Desktop, Claude Code, Cursor, VS Code MCP extension) to probe the API, verify webhook signatures, and work with B4bit Pay data without writing HTTP code.\n\n## Install\n\nTwo ways:\n\n### 1. Via `npx` (recommended for end users)\n\nNo install step. Just add this to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"b4bit-pay\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@b4bit/b4bit-pay-mcp\"],\n      \"env\": {\n        \"B4BIT_API_KEY\": \"<your-device-api-key>\"\n      }\n    }\n  }\n}\n```\n\n### 2. Local install\n\n```bash\npnpm add -D @b4bit/b4bit-pay-mcp\n```\n\nThen point the client to `node_modules/.bin/b4bit-pay-mcp`.\n\n## Configuration\n\n| Env var | Required | Default | Purpose |\n|---------|:-:|---------|---------|\n| `B4BIT_API_KEY` | ✓ | — | Device API Key (UUID) from [pay.b4bit.com/settings/commerce/devices](https://pay.b4bit.com/settings/commerce/devices) |\n| `B4BIT_BASE_URL` | — | `https://pos.b4bit.com/api/v1` | Override for staging/local testing |\n\n## Tools\n\n### Generic\n\n| Tool | Purpose |\n|------|---------|\n| `probe_endpoint` | Arbitrary HTTP against `pos.b4bit.com/api/v1/*`. Supports `dry_run`. |\n| `verify_webhook` | Validate HMAC-SHA256 of a webhook. Returns diagnostics when invalid. |\n| `list_endpoints` | Catalog of the 5 public endpoints. |\n\n### Typed (less error-prone for agents)\n\n| Tool | Endpoint | Notes |\n|------|----------|-------|\n| `list_currencies` | `GET /currencies` | Authoritative source for symbols. |\n| `create_order` | `POST /orders/` | JSON body. All optional fields. |\n| `get_order` | `GET /orders/info/{id}` | Returns array of 1. |\n| `list_orders` | `GET /orders/` | Default last 7 days. |\n| `create_device` | `POST /device/` | **Destructive** — requires `confirm_creation: true`. |\n| `map_status` | — | Maps `NR|PE|AC|IA|CO|CA|EX|OC|FA|DE|CM` + `safe` → merchant state. |\n\n## Webhook HMAC test vector\n\n`verify_webhook` self-validates on the official vector:\n\n- `secret_hex`: `02d4b921007cad413e79731dd02b3267cd43a14d150a0ae6a1c651942122bb62`\n- `nonce`: `1645634942`\n- `body`: `{\"fiat_amount\": 100.0, \"fiat_currency\": \"USD\", \"status\": \"AC\", \"crypto_amount\": 1.21461894, \"unconfirmed_amount\": 8.0, \"confirmed_amount\": 0.0, \"currency\": \"DASH\", \"identifier\": \"1040095a-737d-41a2-a2e1-d031d19ec8cd\"}`\n- Expected `signature`: `395a6c0294f0896fcc0e5827e926e12308f4fdca5c18da69d3af6879e5c80e2d`\n\nWhen invalid, the tool returns actionable diagnostics (wrong secret encoding, trimmed body, reversed concatenation, etc.).\n\n## Dev\n\n```bash\npnpm install\npnpm dev        # tsx watch\npnpm build      # tsc -> dist/\npnpm start      # node dist/index.js\npnpm test       # vitest\n```\n\n## Docs\n\nFull documentation for the API: [https://docs.b4bit.com/pay/api/](https://docs.b4bit.com/pay/api/).\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n","readmeFilename":"README.md","_rev":"1-e5a0885b7762b45a644611bc28c32f22"}