# Whiteflow (npm · whiteflow-mcp)

USDT payment links, payments and collection summaries on Whitechain testnet. Can't move money.

- Trust score: 71/100 (medium)
- Change this week: 0
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- npm · `whiteflow-mcp`: 71/100 (this document), [markdown](https://verifymcp.io/servers/vishal4742-whiteflow/whiteflow-mcp.md), [page](https://verifymcp.io/servers/vishal4742-whiteflow/whiteflow-mcp)

## Channel facts

- Registry: `npm`
- Package: `whiteflow-mcp`
- Version: `0.3.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 13 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 80/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2014 tokens (~143/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 93/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 80% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 14 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Whiteflow MCP server?

Whiteflow runs locally as an npm package, launched with npx -y whiteflow-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add vishal4742-whiteflow -- npx -y whiteflow-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "vishal4742-whiteflow": {
      "command": "npx",
      "args": [
        "-y",
        "whiteflow-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "vishal4742-whiteflow": {
      "command": "npx",
      "args": [
        "-y",
        "whiteflow-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add vishal4742-whiteflow -- npx -y whiteflow-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "vishal4742-whiteflow": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "whiteflow-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add vishal4742-whiteflow --command npx --arg -y --arg whiteflow-mcp
```

### Hermes

```yaml
mcp_servers:
  vishal4742-whiteflow:
    command: "npx"
    args: ["-y", "whiteflow-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "vishal4742-whiteflow": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "whiteflow-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add vishal4742-whiteflow -t stdio -c npx -a -y whiteflow-mcp
```

### Other

```json
{
  "mcpServers": {
    "vishal4742-whiteflow": {
      "command": "npx",
      "args": [
        "-y",
        "whiteflow-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-09 (score 71, 0)

- [functional improvement] Security disclosure: fail → pass

### 2026-11-07 (score 71)

First indexed and scored.

## MCP tools (14)

### `get_business_profile` (~67 tokens)

Get business profile

The signed-in business: name, environment (sandbox or testnet), time zone and today's date there, supported price currencies, invoice currency, payment methods and limits, and what this API key may do. Call it first, and resolve relative dates ("next Friday") against its `today`.

### `search_customers` (~87 tokens)

Search customers

Find existing customers by name or email (part of either). Returns stable customer ids with a masked email. Use it before create_customer, and to turn a name into the customer_id an invoice needs.

Input parameters:

- `limit` (integer): At most this many, 1 to 20.
- `query` (string, required): Part of the customer's name or email, e.g. "Acme".

### `create_customer` (~187 tokens)

Create customer

Create a customer with only what's needed: a name, and an email if the merchant gives one. Refuses a likely duplicate (same name or email) and lists it instead; pass confirm_new only after the merchant confirms it's a different customer.

Input parameters:

- `confirm_new` (boolean): true only after the merchant confirmed that a listed possible duplicate is a different customer.
- `create_another` (boolean): true only when the merchant deliberately wants a second record identical to one just created (e.g. two identical sales). Never to retry an error.
- `email` (string): Optional email, only if the merchant gave it.
- `idempotency_key` (string): Optional, advanced: your own key for this exact request. Leave it out normally: a retry of an unresolved request is resumed automatically.
- `name` (string, required): The customer's or company's name, as the merchant said it.

### `create_payment_link` (~349 tokens)

Create payment link

Create a hosted payment link and return its URL and status. It is NOT sent to anyone: the merchant shares the URL. Single-use by default (one payment closes it). currency is the price's currency, exactly as the merchant said it (₹ → INR, $ → USD); never convert it yourself. A price not in USDT is converted by Whiteflow at checkout.

Input parameters:

- `amount` (string, required): The price as a decimal string in `currency`, e.g. "15000" or "15000.00" (at most 2 decimals for fiat, 6 for USDT).
- `create_another` (boolean): true only when the merchant deliberately wants a second record identical to one just created (e.g. two identical sales). Never to retry an error.
- `currency` (string, required): The price's currency, as the merchant stated it. Ask if unclear; don't assume.
- `customer_id` (string): Optional customer id from search_customers/create_customer (sandbox backend only).
- `description` (string, required): What it's for, shown to the customer, e.g. "Acme website redesign".
- `expires_on` (string): Optional last day the link can be paid, YYYY-MM-DD in the business time zone (it closes at the end of that day).
- `idempotency_key` (string): Optional, advanced: your own key for this exact request. Leave it out normally: a retry of an unresolved request is resumed automatically.
- `reference` (string): Optional merchant reference (unique per link), e.g. an order number.
- `single_use` (boolean): true (default): closes after one payment. false: a reusable link.

### `get_payment_link` (~63 tokens)

Get payment link

A payment link's current status (active, paid, expired, cancelled) and the verified payments made through it, newest first, from Whiteflow's own records.

Input parameters:

- `link_id` (string, required): The link id, like lnk_…, from create_payment_link.

### `create_invoice_draft` (~292 tokens)

Create invoice draft

Save a private invoice DRAFT (not sent, not payable) for an existing customer_id: line items with quantity × unit price, a due date, and only an explicit discount or tax the merchant stated. Invoices are in USDT, the settlement asset: if the merchant priced in another currency, ask for the USDT amounts or offer a payment link; never convert. Never invent a tax rate. Resolve a relative due date ("next Friday") with get_business_profile's today and confirm the resulting date.

Input parameters:

- `create_another` (boolean): true only when the merchant deliberately wants a second record identical to one just created (e.g. two identical sales). Never to retry an error.
- `currency` (string, required): Must be "USDT".
- `customer_id` (string, required): From search_customers or create_customer. Never a name.
- `discount`: Only if the merchant asked for one.
- `due_date` (string, required): YYYY-MM-DD in the business time zone; today or later.
- `idempotency_key` (string): Optional, advanced: your own key for this exact request. Leave it out normally: a retry of an unresolved request is resumed automatically.
- `line_items` (array, required)
- `memo` (string): Optional note shown on the invoice.
- `tax` (object): Only a tax the merchant explicitly named, with its rate. Never infer one.

### `update_invoice_draft` (~171 tokens)

Update invoice draft

Change a DRAFT before publication: customer, line items, due date, discount, tax or memo (give only what changes; `discount: null` / `tax: null` removes one). It creates a new revision, and any pending publication approval for the old one is cancelled. Published invoices can't be edited.

Input parameters:

- `customer_id` (string)
- `discount`
- `due_date` (string)
- `idempotency_key` (string): Optional, advanced: your own key for this exact request. Leave it out normally: a retry of an unresolved request is resumed automatically.
- `invoice` (string, required): The invoice id (inv_…) or its number (WF-1042).
- `line_items` (array)
- `memo`
- `tax`

### `finalize_invoice` (~152 tokens)

Request invoice publication

Ask to publish a reviewed DRAFT. This doesn't publish by itself: Whiteflow creates an approval request for this exact version (total, currency, customer), and an Owner of the business approves it on the review page; then the invoice gets its number and payment URL. A conversation 'yes' is not that approval. The connector re-checks the totals first and refuses if they don't add up. Nothing is emailed or sent.

Input parameters:

- `idempotency_key` (string): Optional, advanced: your own key for this exact request. Leave it out normally: a retry of an unresolved request is resumed automatically.
- `invoice` (string, required): The invoice id (inv_…) or its number (WF-1042).

### `get_invoice` (~77 tokens)

Get invoice

An invoice's status (draft, awaiting approval, open, overdue, paid), totals, amount paid and still due, due date, payment URL, and its verified payments. Paid status comes only from Whiteflow's verified payment records.

Input parameters:

- `invoice` (string, required): The invoice id (inv_…) or its number (WF-1042).

### `list_invoices` (~115 tokens)

List invoices

Invoices newest first, filtered by customer, status (draft, open, paid, overdue) and due-date range, with a cursor for the next page. Amounts stay in each invoice's own currency.

Input parameters:

- `cursor` (string): The `next_cursor` of the previous page.
- `customer_id` (string)
- `due_from` (string): YYYY-MM-DD, inclusive.
- `due_to` (string): YYYY-MM-DD, inclusive.
- `limit` (integer)
- `status` (string)

### `prepare_invoice_reminder` (~70 tokens)

Prepare invoice reminder

Draft a payment reminder for an open invoice: subject, body, the intended recipient and the payment URL. It does NOT send anything (sent: false); the merchant reviews and sends it.

Input parameters:

- `invoice` (string, required): The invoice id (inv_…) or its number (WF-1042).

### `list_payments` (~80 tokens)

List payments

Verified payments received, newest first: amount in USDT, refunded amount, time, the related invoice or link, and evidence (an explorer link on testnet). A cursor pages through older ones.

Input parameters:

- `cursor` (string): The `next_cursor` of the previous page.
- `limit` (integer): How many, 1 to 100.

### `get_collection_summary` (~109 tokens)

Collection summary

Money collected in a period (gross, fees, refunds, net and count, per currency) and, where the backend has invoices, what is outstanding and overdue now. Days are the business's own time zone. Give a period, or from and to.

Input parameters:

- `from` (string): YYYY-MM-DD, inclusive (with to; instead of period).
- `period` (string): this_week starts on Monday. Default: this_week.
- `to` (string): YYYY-MM-DD, inclusive.

### `get_operation_status` (~133 tokens)

Operation status

Writes whose outcome is still unknown or needs reconciliation (after a timeout, a lost reply, or a reply that didn't match the request), or one write by its idempotency_key: what was attempted, when, and what Whiteflow's records say. Pass acknowledge: true only after the merchant has checked the record themselves; it clears the local flag so a new, identical request can be made.

Input parameters:

- `acknowledge` (boolean): With idempotency_key: the merchant checked this record; stop treating it as unresolved.
- `idempotency_key` (string): One operation; leave out to list every unresolved one.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/vishal4742-whiteflow/whiteflow-mcp#diagnostics

## Score history

- 2026-11-21: 71
- 2026-11-20: 71
- 2026-11-19: 71
- 2026-11-18: 71
- 2026-11-17: 71
- 2026-11-16: 71
- 2026-11-15: 71
- 2026-11-14: 71
- 2026-11-13: 71
- 2026-11-12: 71
- 2026-11-11: 71
- 2026-11-10: 71
- 2026-11-09: 71
- 2026-11-08: 71
- 2026-11-07: 71

## Common questions

### What is the Whiteflow MCP server?

Whiteflow is an MCP server listed in the public MCP registry as io.github.Vishal4742/whiteflow. USDT payment links, payments and collection summaries on Whitechain testnet. Can't move money. This page covers its npm package (whiteflow-mcp).

### Is the Whiteflow MCP server safe to use?

Whiteflow scores 71 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Whiteflow MCP server expose?

Whiteflow exposes 14 tools: get_business_profile, search_customers, create_customer, create_payment_link, get_payment_link, and 9 more. Their descriptions and schemas cost roughly 1,952 tokens of context every time the server is loaded.

### Is the Whiteflow MCP server still maintained?

Whiteflow is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Whiteflow MCP server under?

Whiteflow declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Whiteflow MCP server?

VerifyMCP ran 15 checks on Whiteflow, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Whiteflow: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/whiteflow-mcp
- Socket report: https://socket.dev/npm/package/whiteflow-mcp
- Repository: https://github.com/Vishal4742/whiteflow
- Website: https://whiteflow.org/mcp
- Changelog RSS feed: https://verifymcp.io/servers/vishal4742-whiteflow/whiteflow-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/vishal4742-whiteflow/whiteflow-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/vishal4742-whiteflow/whiteflow-mcp.json
- HTML version of this page: https://verifymcp.io/servers/vishal4742-whiteflow/whiteflow-mcp
