agentpay — card-funded wallets for AI agents
Prepaid USD wallets for AI agents: card top-ups, scoped keys, BSV x402 payments over MCP.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (2)
- LOWTool 'get_balance' description lacks action verben get_balance
- LOWTool 'revoke_subagent' description lacks action verben revoke_subagent
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"agentpay": {
"url": "https://entangleit.com/api/agentpay/mcp"
}
}
}Puntos de conexión remotos
https://entangleit.com/api/agentpay/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (24)
🟢health
Check that the agentpay API and MCP are up.
Esquema de entrada
{
"type": "object",
"properties": {}
}🟢get_balance(key)
Wallet balance, agent identity, and daily limit status for the current agent key.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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).
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia