io.github.ShieldZCash/mcp

Official3 toolsLive

by ShieldZCash · JavaScript

Keyless non-custodial crypto payments for AI agents: payment links and tip jars, no API key.

io.github.ShieldZCash/mcp MCP Server

This Model Context Protocol (MCP) server for Shieldz enables AI agents to accept non-custodial crypto payments and sell digital products. It supports keyless payments via payment links and tip jars, using a destination wallet address provided by the user, with settlement to that wallet.

🛠️ Key Features

Non-custodial crypto payments
Payment links and tip jars
“Keyless” operation: no account and no API key
Funds settle to the wallet address you provide
MCP toolset count: 3

🚀 Use Cases

Allow an AI agent (e.g., Claude) to accept crypto payments
Enable purchase flows for digital products
Support tipping for agent services

⚡ Developer Benefits

Keyless integration (destination wallet address in one call)
Shareable artifacts: one-time payment link (shareable URL, embeddable button, QR)

⚠️ Limitations

Tool details beyond create_payment_link are not included in the provided excerpt.

Topics

aicrypto-paymentsmcpmodel-context-protocolnon-custodialai-agentscrypto-payment-gatewaypayment-gatewaypayments

Captured live from the server via tools/list.

create_payment_link

Create a one-time crypto payment link with ZERO setup, no account, no API key. Give a destination wallet address and an amount; get back a shareable pay_url, an embeddable button, and a manage_url. Non-custodial: funds settle directly to the address you provide.

Parameters6

address	string	required	Destination wallet (0x EVM address); funds settle here.
amount_usd	number	required	Amount in USD, e.g. 49 for $49.00
chain	string	optional	Settlement chain (default base)
asset	string	optional	Stablecoin (default USDC)
memo	string	optional	Description shown on the checkout
email	string	optional	Optional, lets the owner claim a dashboard later

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Destination wallet (0x EVM address); funds settle here."
    },
    "amount_usd": {
      "type": "number",
      "description": "Amount in USD, e.g. 49 for $49.00"
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "arbitrum",
        "optimism",
        "polygon",
        "ethereum"
      ],
      "description": "Settlement chain (default base)"
    },
    "asset": {
      "type": "string",
      "enum": [
        "USDC",
        "USDT"
      ],
      "description": "Stablecoin (default USDC)"
    },
    "memo": {
      "type": "string",
      "description": "Description shown on the checkout"
    },
    "email": {
      "type": "string",
      "description": "Optional, lets the owner claim a dashboard later"
    }
  },
  "required": [
    "address",
    "amount_usd"
  ]
}

create_tip_jar

Create a reusable 'pay what you want' tip jar with ZERO setup. The payer chooses the amount. Returns a shareable /tip url, an embeddable button, and a manage_url. Idempotent per wallet address. Non-custodial.

Parameters8

address	string	required	Destination wallet (0x EVM address); funds settle here.
chain	string	optional	Settlement chain (default base)
asset	string	optional	Stablecoin (default USDC)
title	string	optional	Heading shown on the tip page, e.g. 'Buy me a coffee'
description	string	optional
suggested_amounts_usd	array	optional	Preset amount buttons in USD, e.g. [3, 5, 10]
slug	string	optional	Optional custom URL slug
email	string	optional	Optional, lets the owner claim a dashboard later

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Destination wallet (0x EVM address); funds settle here."
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "arbitrum",
        "optimism",
        "polygon",
        "ethereum"
      ],
      "description": "Settlement chain (default base)"
    },
    "asset": {
      "type": "string",
      "enum": [
        "USDC",
        "USDT"
      ],
      "description": "Stablecoin (default USDC)"
    },
    "title": {
      "type": "string",
      "description": "Heading shown on the tip page, e.g. 'Buy me a coffee'"
    },
    "description": {
      "type": "string"
    },
    "suggested_amounts_usd": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Preset amount buttons in USD, e.g. [3, 5, 10]"
    },
    "slug": {
      "type": "string",
      "description": "Optional custom URL slug"
    },
    "email": {
      "type": "string",
      "description": "Optional, lets the owner claim a dashboard later"
    }
  },
  "required": [
    "address"
  ]
}

get_account_status

Look up a keyless Shieldz account by its manage_token (returned when you create a payment link or tip jar). Returns settlement details, tip jars, totals (paid/pending), and the invoice list as structured JSON.

Parameters1

manage_token

string

required

The manage_token from create_payment_link / create_tip_jar

Raw schema

{
  "type": "object",
  "properties": {
    "manage_token": {
      "type": "string",
      "description": "The manage_token from create_payment_link / create_tip_jar"
    }
  },
  "required": [
    "manage_token"
  ]
}

README.md2 KBView on GitHub

@shieldz/mcp

Model Context Protocol (MCP) server for Shieldz. Lets an AI agent (Claude, etc.) accept non-custodial crypto payments and sell digital products.

Funds always settle to the wallet address you provide. Shieldz never holds your keys.

Keyless tools (no account, no API key)

Give a destination wallet address and start accepting crypto in one call:

create_payment_link — a one-time payment link (shareable URL + embeddable button + QR). Args: address, amount_usd, optional chain (default base), asset (default USDC), memo, email.
create_tip_jar — a reusable "pay what you want" page; the payer chooses the amount. Args: address, optional chain, asset, title, suggested_amounts_usd, slug, email.
create_unlock — sell a digital product: a pay-to-unlock page for a file link, license key, or secret text (up to 100k chars). The buyer pays and the payload is revealed on their paid confirmation, automatically. Args: address, price_usd, payload, aup_accepted, optional title, description, chain, asset, email. (To deliver an uploaded file up to 10 MB, post multipart to /api/v1/unlocks.)
get_account_status — look up settlement details, tip jars, totals, and invoices by manage_token.

These work with zero configuration. Pass an optional email so the owner can claim a full dashboard later via magic link.

Remote (no install) — point any MCP client at the hosted server:

json

{ "mcpServers": { "shieldz": { "url": "https://shieldz.cash/mcp" } } }

Local (stdio) — run via npx:

json

{
  "mcpServers": {
    "shieldz": {
      "command": "npx",
      "args": ["-y", "@shieldz/mcp"]
    }
  }
}

API-key tools (full merchant account)

Set SHIELDZ_API_KEY to additionally enable richer invoice management: create_invoice, get_invoice, list_invoices.

json

{
  "mcpServers": {
    "shieldz": {
      "command": "npx",
      "args": ["-y", "@shieldz/mcp"],
      "env": { "SHIELDZ_API_KEY": "sk_live_…" }
    }
  }
}

Get an API key from your merchant dashboard → Developers.

Environment

SHIELDZ_API_KEY (optional) — enables the invoice tools. Omit for keyless mode.
SHIELDZ_BASE_URL (optional) — defaults to https://shieldz.cash.

License

Install

Tools (3)

create_payment_linkcreate_tip_jarget_account_status

Configuration

Environment variables

SHIELDZ_API_KEYsecret

Optional. Set a sk_live_/sk_test_ key to additionally enable full invoice management tools. Omit for keyless mode.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shieldz/mcp@0.3.0"
      ],
      "env": {
        "SHIELDZ_API_KEY": "<YOUR_SHIELDZ_API_KEY>"
      }
    }
  }
}

io.github.ShieldZCash/mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

create_payment_link

create_tip_jar

get_account_status

@shieldz/mcp

Keyless tools (no account, no API key)

API-key tools (full merchant account)

Environment

License

Install

Configuration

Related servers