Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.voidly-ai/pay-mcp

NPM · @VOIDLY/PAY-MCP · SCANNED AUG 3

USDC-backed agent payments. Transfer, escrow, x402 paywall, streams, subs. 28 tools.

Available components

+18 this week 63 Trust /100
Trust breakdown (6 categories)

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. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability71
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 1961 tokens (~70/item across 28 items; 28 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage87
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 62% of tool parameters carry a description.Partial
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

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

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @voidly/pay-mcp

# add to Claude Code
claude mcp add voidly-ai-pay-mcp -- npx -y @voidly/pay-mcp
# add to Codex CLI
codex mcp add voidly-ai-pay-mcp -- npx -y @voidly/pay-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "voidly-ai-pay-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@voidly/pay-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add voidly-ai-pay-mcp --command npx --arg -y --arg @voidly/pay-mcp
# ~/.hermes/config.yaml
mcp_servers:
  voidly-ai-pay-mcp:
    command: "npx"
    args: ["-y", "@voidly/pay-mcp"]
// mcp.json
{
  "mcpServers": {
    "voidly-ai-pay-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@voidly/pay-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 2 Aug 26 +43
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool coverage: 100 → unverified functional
    • Security disclosure: fail → unverified functional
    • Schema quality: unverified → good functional
    • MCP protocol: unverified → pass functional
    • Maintenance: unverified → pass functional
    • Dependency health: unverified → partial functional
    • License: unverified → pass functional
    • Licence: MIT functional
  • 1 Aug 26 +15
    • Tool coverage: unverified → 100 functional
  • 31 Jul 26 −40
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 +21
    • Tool coverage: unverified → 100 functional
  • 28 Jul 26 −21
    • Tool coverage: 100 → unverified functional
    • First check of Schema quality: unverified functional
  • 27 Jul 26 45

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@voidly/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 28 exposed · ~1,961 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
agent_escrow_open ~82

Voidly Pay: Open an escrow hold. Locks `amount` credits from the caller's wallet. Auto-expires past `deadline_hours`.. Returns JSON.

NameTypeReqDescription
amountnumberyes
deadline_hoursnumberdefault 24, max 168 (7 days)
memostring
tostringyes

No output schema declared.

No examples provided.

agent_escrow_refund ~54

Voidly Pay: Refund an open escrow back to the sender. Caller must be the original sender.. Returns JSON.

NameTypeReqDescription
escrow_idstringyes
reasonstringoptional ≤280 chars

No output schema declared.

No examples provided.

agent_escrow_release ~41

Voidly Pay: Release an open escrow to its recipient. Caller must be the original sender.. Returns JSON.

NameTypeReqDescription
escrow_idstringyes

No output schema declared.

No examples provided.

agent_pay ~101

Voidly Pay: Sign + settle a one-shot transfer. Amount is in CREDITS (1 credit = 1,000,000 micro). Returns the transfer receipt.. Returns JSON.

NameTypeReqDescription
amountnumberyescredits (e.g. 0.5)
expires_in_minutesnumberenvelope expiry (default 30)
memostringoptional, ≤280 chars
tostringyesrecipient did:voidly:...

No output schema declared.

No examples provided.

agent_pay_activity ~57

Voidly Pay: Most-recent state changes across all primitives (transfers, escrows, hires, streams, subscriptions). Public; no signing.. Returns JSON.

NameTypeReqDescription
limitnumber1-200, default 50

No output schema declared.

No examples provided.

agent_pay_batch ~53

Voidly Pay: Atomic multi-recipient transfer. items: [{to, amount, memo?}]. All-or-nothing. Returns batch summary + per-item receipts.. Returns JSON.

NameTypeReqDescription
itemsarrayyes

No output schema declared.

No examples provided.

agent_pay_feed ~63

Voidly Pay: Incremental, append-only feed of settled transfers. Use `since` cursor from the previous response's next_since.. Returns JSON.

NameTypeReqDescription
limitnumber1-200, default 50
sincestringISO cursor

No output schema declared.

No examples provided.

agent_pay_get ~44

Voidly Pay: Look up a transfer by id. Returns the ledger row including signature, envelope_hash, and status.. Returns JSON.

NameTypeReqDescription
transfer_idstringyes

No output schema declared.

No examples provided.

agent_pay_health ~33

Voidly Pay: System-frozen flag + counts of wallets and 24h-settled transfers.. Returns JSON.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

agent_pay_health_check ~148

Voidly Pay: One-call trust report. Aggregates /v1/pay/health + /v1/pay/manifest.json + (optionally) the on-chain vault USDC balance into a structured pass/fail breakdown. Returns ok:true only if every individual check passes — system not frozen, manifest declares a Stage 2 vault, vault is on Base mainnet, source verified on Sourcify, vault holds USDC. Use this before relying on the rail for anything you care about settling.. Returns JSON.

NameTypeReqDescription
rpcUrlstringPublic Base RPC. Default: https://mainnet.base.org
skipChainbooleanSkip the on-chain vault balance read.

No output schema declared.

No examples provided.

agent_pay_leaderboard ~70

Voidly Pay: Top earners or spenders. metric: earned_24h | earned_total | spent_24h | spent_total | hires_24h.. Returns JSON.

NameTypeReqDescription
limitnumber1-200, default 25
metricstring

No output schema declared.

No examples provided.

agent_pay_manifest ~31

Voidly Pay: Discovery manifest: every endpoint, schema, defaults, and MCP tool list.. Returns JSON.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

agent_pay_self ~30

Voidly Pay: Get the SDK's own DID, public key, and current balance.. Returns JSON.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

agent_pay_stats ~33

Voidly Pay: Platform-wide aggregates — capabilities, hires, value settled, top providers, recent activity.. Returns JSON.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

agent_pay_trust ~51

Voidly Pay: Derived provider+requester stats for a DID — completion rate, rating avg, total earned. Useful before a hire decision.. Returns JSON.

NameTypeReqDescription
didstringdefault self

No output schema declared.

No examples provided.

agent_payment_history ~59

Voidly Pay: Paginated history of transfers for a DID (defaults to self).. Returns JSON.

NameTypeReqDescription
beforestringISO cursor
didstring
limitnumberdefault 20, max 200

No output schema declared.

No examples provided.

agent_stream_finalize ~86

Voidly Pay: Requester-side: finalize a stream. Acknowledges the metered total + last seq + last hash. Settles metered amount to provider, refunds rest to requester.. Returns JSON.

NameTypeReqDescription
expected_hashstring|null
expected_seqnumberyes
metered_total_micronumberyes
stream_idstringyes

No output schema declared.

No examples provided.

agent_stream_meter ~132

Voidly Pay: Provider-side: append a signed meter entry to an open stream. seq starts at 1 and increments. prev_hash is the last entry's this_hash (or null for seq=1). Returns this_hash for chaining the next.. Returns JSON.

NameTypeReqDescription
deltanumberyescredits to add to the meter
prev_hashstringprevious entry's this_hash, or null for seq=1
seqnumberyesmonotonically increasing, ≥1
stream_idstringyes
unitsnumberoptional unit count (e.g. tokens used)

No output schema declared.

No examples provided.

agent_stream_open ~107

Voidly Pay: Open a metered payment stream. Locks `budget` credits as a max. Provider appends signed meter entries. Use for per-token / per-second billing.. Returns JSON.

NameTypeReqDescription
budgetnumberyesmax credits
deadline_minutesnumberdefault 60
descriptionstring
providerstringyesprovider's did:voidly:...
unit_labelstringe.g. 'tokens', 'ms', 'bytes'

No output schema declared.

No examples provided.

agent_subscribe ~94

Voidly Pay: Create a recurring subscription. Pulls `amount_per_period` from caller's balance every `period_seconds`. Auto-pauses after 3 consecutive failures.. Returns JSON.

NameTypeReqDescription
amount_per_periodnumberyes
descriptionstring
period_secondsnumberyesmin 60
periods_totalnumberoptional cap; omit for unlimited
providerstringyes

No output schema declared.

No examples provided.

agent_subscription_cancel ~46

Voidly Pay: Cancel a subscription. Either party (requester or provider) may cancel.. Returns JSON.

NameTypeReqDescription
reasonstring
subscription_idstringyes

No output schema declared.

No examples provided.

agent_wallet_balance ~57

Voidly Pay: Read the wallet for a DID. Returns balance, locked, caps, frozen flag. If `did` omitted, defaults to self.. Returns JSON.

NameTypeReqDescription
didstringdid:voidly:... (optional)

No output schema declared.

No examples provided.

agent_wallet_ensure ~45

Voidly Pay: Idempotent: create wallet for a DID if it doesn't exist. Useful before sending the first payment.. Returns JSON.

NameTypeReqDescription
didstringyes

No output schema declared.

No examples provided.

agent_webhook_delete ~35

Voidly Pay: Revoke a webhook subscription owned by the caller.. Returns JSON.

NameTypeReqDescription
webhook_idstringyes

No output schema declared.

No examples provided.

agent_webhook_subscribe ~106

Voidly Pay: Subscribe to pay events via HMAC-signed webhook. Returns webhook_id and a `secret` (returned ONCE) for signature verification.. Returns JSON.

NameTypeReqDescription
descriptionstring
did_filterstringonly fire when this DID is involved
eventsarrayfilter: ['transfer.settled', 'stream.finalized', ...]; omit for all
urlstringyeshttps only (loopback blocked)

No output schema declared.

No examples provided.

agent_x402_fetch ~100

Voidly Pay: Fetch a URL; if it returns HTTP 402, parse the quote, transfer, retry. Returns the FINAL response status and body. `max_amount` caps how much the agent will pay.. Returns JSON.

NameTypeReqDescription
bodystringoptional request body
max_amountnumbermax credits to pay (default 0.01)
methodstringdefault GET
urlstringyes

No output schema declared.

No examples provided.

agent_x402_quote ~112

Voidly Pay: Server-side: create an x402 quote. Returns a payment_required_response that the server should serve verbatim with HTTP 402.. Returns JSON.

NameTypeReqDescription
amountnumberyescredits
descriptionstring
methodstringHTTP method (optional)
recipientstringwhere to send the money (default: self)
resourcestringyesURL path or label
ttl_secondsnumberdefault 600, max 3600

No output schema declared.

No examples provided.

agent_x402_verify ~91

Voidly Pay: Server-side: verify + consume an x402 payment. Pass the X-Payment header value the caller sent. Atomic; UNIQUE replay protection at the DB.. Returns JSON.

NameTypeReqDescription
payment_headerstringvalue of the X-Payment header
quote_idstringredundant if payment_header carries it
transfer_idstringredundant if payment_header carries it

No output schema declared.

No examples provided.