Skip to main content
Glama
ShieldZCash

ShieldZ Crypto Payments

Official

@shieldz/mcp

npm

适用于 Shieldz 的 Model Context Protocol (MCP) 服务器。 让 AI 智能体(如 Claude 等)接受非托管加密货币支付并销售数字产品。

资金始终结算到您提供的钱包地址。Shieldz 永远不会持有您的密钥。

无密钥工具(无需账户,无需 API 密钥)

传入一个目标钱包地址,一次调用即可开始接受加密货币:

  • create_payment_link — 一次性支付链接(可分享的 URL + 可嵌入按钮 + 二维码)。参数:addressamount_usd,可选 chain(默认 base)、asset(默认 USDC)、memoemail

  • create_tip_jar — 可重复使用的“随心付”页面;付款人自行选择金额。参数:address,可选 chainassettitlesuggested_amounts_usdslugemail

  • create_unlock销售数字产品:付费解锁页面,用于提供文件链接、许可证密钥或机密文本(最多 100k 字符)。买家付款后,其付款确认页会自动显示有效载荷。参数:addressprice_usdpayloadaup_accepted,可选 titledescriptionchainassetemail。(若要交付上传的文件(最大 10 MB),请以 multipart 方式 POST 到 /api/v1/unlocks。)

  • get_account_status — 通过 manage_token 查询结算详情、打赏罐、总额和发票。

这些功能零配置即可使用。传入可选的 email,所有者之后便可通过魔法链接认领完整的仪表盘。

远程(无需安装) — 将任意 MCP 客户端指向托管服务器:

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

本地(stdio) — 通过 npx 运行:

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

Related MCP server: PayRam MCP Server

API 密钥工具(完整商户账户)

设置 SHIELDZ_API_KEY 以额外启用更丰富的发票管理:create_invoiceget_invoicelist_invoices

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

从您的商户仪表盘 → 开发者获取 API 密钥。

环境变量

  • SHIELDZ_API_KEY(可选)— 启用发票工具。省略此项则以无密钥模式运行。

  • SHIELDZ_BASE_URL(可选)— 默认为 https://shieldz.cash

许可证

MIT © Deniz Yanbollu / Shieldz

Available Tools

3 tools
create_tip_jarAInspect

Create a reusable 'pay what you want' tip jar with ZERO setup, no account, no API key. The payer chooses the amount. Returns a shareable /tip url, an embeddable button, and a manage_url. Idempotent per wallet address: calling again updates the same tip jar. Non-custodial: funds settle directly to the address you provide.

ParametersJSON Schema
NameRequiredDescriptionDefault
slugNoOptional custom URL slug; auto-generated if omitted
assetNoDefaults to USDC
chainNoDefaults to base
emailNoOptional, lets the owner claim a dashboard later
titleNoHeading shown on the tip page, e.g. 'Buy me a coffee'
addressYesDestination wallet; funds settle here. Shieldz never holds them.
descriptionNo
suggested_amounts_usdNoPreset amount buttons in USD, e.g. [3, 5, 10]

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden and discloses key behaviors: idempotent per wallet address, non-custodial, funds settle directly, and updates the same jar on repeat calls. Could mention potential side effects of updates (e.g., overwriting settings) but overall strong.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with no fluff. First sentence packs purpose and key value propositions; second covers idempotence and non-custodial nature. Every part earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 8 parameters (1 required) and no output schema, the description covers overall function, return types, and behavioral traits. It lacks error cases or edge conditions, but completeness is adequate for a creation tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 88% (high), so baseline is 3. The description adds context beyond schema: confirms the address parameter is the destination and that funds are non-custodial, and suggests amount parameters relate to payer choice. This adds meaningful semantic value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it creates a reusable 'pay what you want' tip jar with zero setup, and specifies return values (shareable URL, embeddable button, manage_url). It distinguishes from siblings like create_payment_link (likely fixed amounts) and get_account_status (different function).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description says 'Create a reusable tip jar with ZERO setup' which implies when to use. However, it does not explicitly contrast with sibling tools or state when NOT to use this tool. The context is clear but lacks exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_account_statusAInspect

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 full invoice list as structured JSON.

ParametersJSON Schema
NameRequiredDescriptionDefault
manage_tokenYesThe manage_token from create_payment_link / create_tip_jar

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Without annotations, the description carries full burden. It specifies exactly what is returned (settlement details, tip jars, totals, invoice list), which discloses the tool's output. However, it does not explicitly state that the operation is read-only.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, zero wasted words. The purpose is front-loaded ('Look up a keyless Shieldz account'), and the output is concisely listed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple, one-parameter lookup tool with no output schema or annotations, the description covers all essential aspects: input source, output contents (structured JSON). No additional information is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema describes the required parameter 'manage_token' as the token from sibling tools. The description reinforces this by referencing the same origin, adding practical context beyond the schema. Schema coverage is 100%.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'look up' and the resource 'keyless Shieldz account' by a specific token. It distinguishes from sibling tools (create_payment_link, create_tip_jar) by focusing on retrieval vs. creation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains the token origin ('returned when you create a payment link or tip jar'), linking to sibling tools. It implies use after creation, but does not explicitly state when not to use or provide alternative conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 3 tool updatesv0.3.0
    • First observedcreate_payment_link
    • First observedcreate_tip_jar
    • First observedget_account_status

TDQS

A4.6/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose: fixed-amount payment link, flexible tip jar, and account status. There is no overlap or ambiguity.

Naming Consistency5/5

All tools follow a consistent verb_noun snake_case pattern (create_payment_link, create_tip_jar, get_account_status), making it easy to infer function from name.

Tool Count5/5

With 3 tools, the server is tightly scoped to its 'zero setup' philosophy, covering the essential operations without unnecessary bloat.

Completeness4/5

The server covers creation of two payment types and status retrieval, but lacks update/delete capabilities for payment links or tip jars, which slightly limits agent workflows.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for AgentPay — the payment gateway for autonomous AI agents. Fund a wallet once, give your agent the key, and it discovers, provisions, and pays for tool APIs on its own. One key, every tool.
    112
    1
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to deploy and operate a self-hosted, no-signup crypto payment gateway with multi-chain support, card-to-crypto checkout, and MCP tools for payment links and integration snippets.
    155
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Accept crypto payments from AI agents: create an invoice in one call and get a hosted checkout link (USDC/USDT on Celo, Base, Arbitrum, Polygon, BSC). No API key, instant self-custody settlement.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ShieldZCash/shieldz-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server