agentpay — card-funded wallets for AI agents

Prepaid USD wallets for AI agents: card top-ups, scoped keys, BSV x402 payments over MCP.

使うべきか

品質と安全性

A
説明の品質
96%
スキーマの完全性
89%
命名の品質
91%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(2)

  • LOWTool 'get_balance' description lacks action verbget_balance 内
  • LOWTool 'revoke_subagent' description lacks action verbrevoke_subagent 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~3,476トークン数(ツール定義)
~1.2 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 2.72%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "agentpay": {
      "url": "https://entangleit.com/api/agentpay/mcp"
    }
  }
}

リモートエンドポイント

https://entangleit.com/api/agentpay/mcpstreamable-http

できること

ツール一覧

ツール(24)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢health

Check that the agentpay API and MCP are up.

入力スキーマ

{
  "type": "object",
  "properties": {}
}
🟢get_balance(key)

Wallet balance, agent identity, and daily limit status for the current agent key.

入力スキーマ

{
  "type": "object",
  "properties": {
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡create_topup_link(amountCents, key)

Create a Stripe Checkout URL that a human opens to fund the wallet. Amount between 100 and 100000 cents USD.

入力スキーマ

{
  "type": "object",
  "properties": {
    "amountCents": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Top-up amount in USD cents, e.g. 2000 = $20"
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "amountCents"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡create_upgrade_link(key)

Create a Stripe Checkout URL to upgrade the wallet to agentpay Pro (more agent keys, higher daily limits, CSV export). Hand the URL to the human who owns the wallet.

入力スキーマ

{
  "type": "object",
  "properties": {
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢list_services(q, limit)

Browse the x402market registry of pay-per-call services for agents. Public — no key needed. Returns tools, network, payTo, and per-tool price in sats.

入力スキーマ

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Search text",
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪service_quote(serviceId, tool, bountyAccount)

Call a registry tool unsigned and return the live 402 payment requirements (price/payTo). Public — no key needed. Pass bountyAccount optionally to include a trust hint (discount eligibility) without changing the price.

入力スキーマ

{
  "type": "object",
  "properties": {
    "serviceId": {
      "type": "string",
      "description": "Registry service id (from list_services)"
    },
    "tool": {
      "type": "string",
      "description": "Tool name on that service"
    },
    "bountyAccount": {
      "description": "BSVBounties account # for trust hint",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "serviceId",
    "tool"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡spend(amountCents, description, service, tool, ref, ...)

Debit the wallet and mint a receipt. Fails with 402 when balance or the agent daily limit is insufficient — respond by calling create_topup_link.

入力スキーマ

{
  "type": "object",
  "properties": {
    "amountCents": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991,
      "description": "Amount in USD cents"
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "service": {
      "description": "Optional service label",
      "type": "string"
    },
    "tool": {
      "description": "Optional tool label",
      "type": "string"
    },
    "ref": {
      "description": "Idempotency-ish external reference",
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior approval_required response",
      "type": "string"
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "amountCents",
    "description"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪pay_service(serviceId, tool, params, amountCents, description, ...)

One call for paid registry tools: quotes the seller's x402 challenge, pays it from the site wallet on BSV mainnet, debits the agent wallet, and returns the seller's result plus txid. If the seller rejects the payment, the debit is refunded. Pass bountyAccount for reputation fast-path (approval x2 when score>=650).

入力スキーマ

{
  "type": "object",
  "properties": {
    "serviceId": {
      "type": "string",
      "description": "Registry service id (from list_services)"
    },
    "tool": {
      "type": "string",
      "description": "Tool name on that service"
    },
    "params": {
      "description": "Tool arguments (body for POST, query for GET)",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "amountCents": {
      "description": "Override the USD cents charged (min 1 cent default)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "description": {
      "type": "string",
      "maxLength": 200
    },
    "ref": {
      "type": "string"
    },
    "approvalId": {
      "description": "Approval id from a prior approval_required response",
      "type": "string"
    },
    "bountyAccount": {
      "description": "BSVBounties account # for trust fast-path",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "dryRun": {
      "description": "Sandbox: quote + policy check only, no debit or settlement",
      "type": "boolean"
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "serviceId",
    "tool"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪mint_subagent(name, budgetCents, dailyLimitCents, expiresInMinutes, allowedTools, ...)

Delegate a scoped child key for a worker: its own lifetime budget (cents), expiry (minutes), daily limit, and tool allowlist. Only top-level agents can delegate. The child can spend only within its budget/expiry/allowlist; revoke it any time.

入力スキーマ

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Worker name, e.g. scraper-1"
    },
    "budgetCents": {
      "description": "Lifetime budget in USD cents (omit for no total cap)",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "dailyLimitCents": {
      "description": "Per-day limit in USD cents",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "expiresInMinutes": {
      "description": "Key expiry (max 30 days)",
      "type": "integer",
      "minimum": 1,
      "maximum": 43200
    },
    "allowedTools": {
      "description": "Allowlist entries like serviceId:tool or serviceId:*",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "approvalAboveCents": {
      "description": "Human approval threshold in cents",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢list_subagents(key)

List the child keys delegated by the current agent, with budget, spend, expiry, and status.

入力スキーマ

{
  "type": "object",
  "properties": {
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪revoke_subagent(agentId, key)

Revoke a delegated child key immediately.

入力スキーマ

{
  "type": "object",
  "properties": {
    "agentId": {
      "type": "string",
      "description": "Sub-agent id from mint_subagent or list_subagents"
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "agentId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_attestation(days, sub, key)

Ask agentpay to sign a summary of this wallet's settled activity (payments, distinct services/payees, spend, refunds, bounty earnings) for a window. Pass sub (workerPubKey) to bind it to a bounty claim — required for bond discount. Free.

入力スキーマ

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Window in days (default 30)",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    },
    "sub": {
      "description": "Claimant binding, e.g. workerPubKey for a bounty claim",
      "type": "string",
      "maxLength": 120
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_receipt(receiptId, key)

Fetch a receipt by id.

入力スキーマ

{
  "type": "object",
  "properties": {
    "receiptId": {
      "type": "string"
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "receiptId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢list_transactions(limit, key)

Recent wallet ledger events (top-ups, spends), newest first.

入力スキーマ

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢list_bounties(status, category, limit, offset)

Browse open paid work on the BSVBounties marketplace (sats rewards, escrow, reputation). Free — no key required.

入力スキーマ

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Bounty status filter (default open)",
      "type": "string",
      "enum": [
        "open",
        "claimed",
        "submitted",
        "paid",
        "refunded"
      ]
    },
    "category": {
      "description": "Category filter, e.g. dev, research, content, data, design",
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢get_bounty(bountyId)

Full detail for one BSVBounties listing: requirements, amount, acceptance spec, status, escrow state.

入力スキーマ

{
  "type": "object",
  "properties": {
    "bountyId": {
      "type": "string",
      "description": "Bounty id from list_bounties"
    }
  },
  "required": [
    "bountyId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪claim_bounty(bountyId, workerAccount, workerPubKey, payoutAddress, key)

Claim a bounty for this wallet. Links the bounty to your agentpay wallet so the reward is credited here on settle; the response includes payout instructions. Pass workerAccount/workerPubKey (BSV identity) to bind trust.

入力スキーマ

{
  "type": "object",
  "properties": {
    "bountyId": {
      "type": "string",
      "description": "Bounty id from list_bounties"
    },
    "workerAccount": {
      "description": "BSVBounties account # doing the work",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "workerPubKey": {
      "description": "BSV worker identity key",
      "type": "string"
    },
    "payoutAddress": {
      "description": "Optional BSV P2PKH payout address for direct sats",
      "type": "string"
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "bountyId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡submit_work(bountyId, workUri, workHash, notes, milestoneIndex, ...)

Submit your work for a bounty you claimed through agentpay. Provide a workUri or notes; the hash is computed by BSVBounties when omitted.

入力スキーマ

{
  "type": "object",
  "properties": {
    "bountyId": {
      "type": "string"
    },
    "workUri": {
      "description": "URL of the deliverable",
      "type": "string"
    },
    "workHash": {
      "description": "sha256 hex of the work, if you compute it yourself",
      "type": "string"
    },
    "notes": {
      "description": "Summary for the poster/verifier — include the payout address from claim_bounty",
      "type": "string"
    },
    "milestoneIndex": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "bountyId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡post_bounty(title, description, category, amountSats, deadline, ...)

Create a bounty funded from this wallet's balance. The reward is escrowed on-chain (real sats, per-bounty key) and listed on BSVBounties. Debits your balance at the posted rate plus the platform fee on payout.

入力スキーマ

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 120
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "category": {
      "description": "dev, research, content, data, design, other (default other)",
      "type": "string"
    },
    "amountSats": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Reward in sats; escrowed on-chain"
    },
    "deadline": {
      "description": "Unix seconds; enables deadline refunds",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "payoutAddress": {
      "description": "Optional BSV P2PKH address for the worker's sats (default: worker's agentpay balance)",
      "type": "string"
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "title",
    "description",
    "amountSats"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪settle_bounty(bountyId, outcome, key)

As the poster, approve a submitted bounty (paid) or refund it. Paid spends the on-chain escrow to the worker (net of fee); refunded returns it to treasury and credits your balance back.

入力スキーマ

{
  "type": "object",
  "properties": {
    "bountyId": {
      "type": "string"
    },
    "outcome": {
      "type": "string",
      "enum": [
        "paid",
        "refunded"
      ]
    },
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "required": [
    "bountyId",
    "outcome"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢my_escrows(key)

List agentpay-funded bounties posted by this wallet: amount, escrow address, funding/payout/refund txids, and any pending error.

入力スキーマ

{
  "type": "object",
  "properties": {
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪claim_trial(name)

Self-serve onboarding: mint a real wallet pre-funded with trial credit plus a tight agent key. No human or card needed. One claim per IP per day from a limited operator budget; fails 403 when the faucet is disabled. Free.

入力スキーマ

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Wallet name, e.g. trial-bot",
      "type": "string",
      "maxLength": 60
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢my_bounties(key)

List bounties this wallet has claimed through agentpay, with status and credited amount.

入力スキーマ

{
  "type": "object",
  "properties": {
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪onboard(key)

First call for a new agent: inspects balance, claims, earnings, and spend history, then returns the single next action (earn first, dry-run spend, link identity, or scale). Free.

入力スキーマ

{
  "type": "object",
  "properties": {
    "key": {
      "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 24 件
検証済みバージョンは記録されていませんツール 24 件