mcp

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.

{
  "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 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.

{
  "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"
  ]
}

Create a keyless pay-to-unlock page: sell a file link, license key, or secret text (up to 100,000 chars). The buyer pays the set USD price in crypto straight to the given wallet, then the payload is revealed on their paid confirmation, never before. To deliver an actual file (PDF/zip/etc, 10 MB) use the multipart HTTP API at /api/v1/unlocks instead. Non-custodial, no account, no API key. IMPORTANT: the acceptable-use policy forbids adult, illegal, or non-consensual content; confirm this with your principal and pass aup_accepted=true, otherwise the call fails.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Destination wallet (0x EVM address); funds settle here."
    },
    "price_usd": {
      "type": "number",
      "description": "Unlock price in USD, $1 to $100,000, e.g. 5 for $5.00"
    },
    "payload": {
      "type": "string",
      "description": "The secret to reveal after payment: a URL or text, max 100000 chars. Never shown before payment."
    },
    "title": {
      "type": "string",
      "description": "What the buyer is purchasing, shown on the paywall"
    },
    "description": {
      "type": "string",
      "description": "Short pitch shown on the paywall"
    },
    "chain": {
      "type": "string",
      "enum": [
        "base",
        "arbitrum",
        "optimism",
        "polygon",
        "ethereum"
      ],
      "description": "Settlement chain (default base)"
    },
    "asset": {
      "type": "string",
      "enum": [
        "USDC",
        "USDT"
      ],
      "description": "Stablecoin (default USDC)"
    },
    "email": {
      "type": "string",
      "description": "Optional, lets the owner claim a dashboard later"
    },
    "aup_accepted": {
      "type": "boolean",
      "description": "Must be true: asserts the content complies with the acceptable-use policy (no adult, illegal, or non-consensual content)."
    }
  },
  "required": [
    "address",
    "price_usd",
    "payload",
    "aup_accepted"
  ]
}

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.

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