English Français العربية

io.github.ShieldZCash/mcp

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع io.github.ShieldZCash/mcp؟

  • 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...
  • get_account_status — look up settlement details, tip jars, totals, and invoices by manage_token.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http io-github-shieldzcash-mcp 'https://shieldz.cash/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-shieldzcash-mcp": {
            "type": "http",
            "url": "https://shieldz.cash/mcp"
        }
    }
}
NPM package @shieldz/mcp
Claude Code 
claude mcp add io-github-shieldzcash-mcp -e 'SHIELDZ_API_KEY=<your shieldz_api_key>' -- npx -y @shieldz/mcp@0.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-shieldzcash-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@shieldz/mcp@0.3.0"
            ],
            "env": {
                "SHIELDZ_API_KEY": "<your shieldz_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • SHIELDZ_API_KEY سري Optional. Set a sk_live_/sk_test_ key to additionally enable full invoice management tools. Omit for keyless mode.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @shieldz/mcp
  2. Keyless tools (no account, no API key)
  3. API-key tools (full merchant account)
  4. License

@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:

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

Local (stdio) — run via npx:

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

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

MIT © Deniz Yanbollu / Shieldz

الأسئلة الشائعة

ما هو io.github.ShieldZCash/mcp؟

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

كيف أثبّت io.github.ShieldZCash/mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http io-github-shieldzcash-mcp 'https://shieldz.cash/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.ShieldZCash/mcp إلى مفتاح API؟

نعم. يتطلب SHIELDZ_API_KEY، وتضبطها في إعداداته.

هل io.github.ShieldZCash/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.ShieldZCash/mcp؟

ينشره ShieldZCash. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.