agentpay — card-funded wallets for AI agents is an MCP server published by com.entangleit, hosted at entangleit.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 27 tools, including health, get_balance, create_topup_link, create_upgrade_link, list_services.
Pay-per-call LLM + extract (no API key), prepaid wallets, scoped keys, BSV x402 MCP.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Check that the agentpay API and MCP are up.
No parameters.
{
"name": "health",
"title": "Health",
"description": "Check that the agentpay API and MCP are up.",
"inputSchema": {
"type": "object",
"properties": {}
}
}Wallet balance, agent identity, and daily limit status for the current agent key.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
{
"name": "get_balance",
"title": "Get balance",
"description": "Wallet balance, agent identity, and daily limit status for the current agent key.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
}
}
}
}Create a Stripe Checkout URL that a human opens to fund the wallet. Amount between 100 and 100000 cents USD.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| amountCents * | integer | Top-up amount in USD cents, e.g. 2000 = $20 |
{
"name": "create_topup_link",
"title": "Create top-up link",
"description": "Create a Stripe Checkout URL that a human opens to fund the wallet. Amount between 100 and 100000 cents USD.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amountCents"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Top-up amount in USD cents, e.g. 2000 = $20"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
{
"name": "create_upgrade_link",
"title": "Create upgrade link",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search text |
| limit | integer |
{
"name": "list_services",
"title": "List paid services",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"description": "Search text"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| tool * | string | Tool name on that service |
| serviceId * | string | Registry service id (from list_services) |
| bountyAccount | integer | BSVBounties account # for trust hint |
{
"name": "service_quote",
"title": "Quote a service",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"serviceId",
"tool"
],
"properties": {
"tool": {
"type": "string",
"description": "Tool name on that service"
},
"serviceId": {
"type": "string",
"description": "Registry service id (from list_services)"
},
"bountyAccount": {
"type": "integer",
"maximum": 9007199254740991,
"description": "BSVBounties account # for trust hint",
"exclusiveMinimum": 0
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| ref | string | Idempotency-ish external reference |
| tool | string | Optional tool label |
| service | string | Optional service label |
| approvalId | string | Approval id from a prior approval_required response |
| amountCents * | integer | Amount in USD cents |
| description * | string |
{
"name": "spend",
"title": "Spend from wallet",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amountCents",
"description"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"ref": {
"type": "string",
"description": "Idempotency-ish external reference"
},
"tool": {
"type": "string",
"description": "Optional tool label"
},
"service": {
"type": "string",
"description": "Optional service label"
},
"approvalId": {
"type": "string",
"description": "Approval id from a prior approval_required response"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Amount in USD cents"
},
"description": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
}
}
}Pay sats to a BSV P2PKH address (on-chain, settlement=live, txid is a BSV transaction) or to an agentpay wallet id apw_… (internal ledger credit, settlement=internal, txid is a receipt id). Idempotent per idempotency_key. Daily limits, allowlists (spend or agent_send), and approval thresholds apply. Pass the public wallet id, never the secret apw_ token.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| dest * | string | BSV P2PKH address (1… / 3…) or public agentpay wallet id (apw_…, not the secret token) |
| memo | string | Optional note stored on the send |
| sats * | integer | Amount in satoshis |
| approvalId | string | Approval id from a prior approval_required response |
| idempotency_key | string | Replay key: a retry with the same key returns the original txid/receipt instead of sending twice |
{
"name": "send",
"title": "Send to an address or wallet",
"description": "Pay sats to a BSV P2PKH address (on-chain, settlement=live, txid is a BSV transaction) or to an agentpay wallet id apw_… (internal ledger credit, settlement=internal, txid is a receipt id). Idempotent per idempotency_key. Daily limits, allowlists (spend or agent_send), and approval thresholds apply. Pass the public wallet id, never the secret apw_ token.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dest",
"sats"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"dest": {
"type": "string",
"description": "BSV P2PKH address (1… / 3…) or public agentpay wallet id (apw_…, not the secret token)"
},
"memo": {
"type": "string",
"maxLength": 200,
"description": "Optional note stored on the send"
},
"sats": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Amount in satoshis",
"exclusiveMinimum": 0
},
"approvalId": {
"type": "string",
"description": "Approval id from a prior approval_required response"
},
"idempotency_key": {
"type": "string",
"maxLength": 120,
"description": "Replay key: a retry with the same key returns the original txid/receipt instead of sending twice"
}
}
}
}One call for paid registry tools: quotes the seller's x402 challenge (legacy single-object or standard v2 accepts[] — BSV exact only), 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. For pay-per-call LLM with no API key, use chat; for typed values from messy text or receipts, use extract. Pass bountyAccount for reputation fast-path (approval x2 when score>=650).
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| ref | string | |
| tool * | string | Tool name on that service |
| dryRun | boolean | Sandbox: quote + policy check only, no debit or settlement |
| params | object | Tool arguments (body for POST, query for GET) |
| serviceId * | string | Registry service id (from list_services) |
| approvalId | string | Approval id from a prior approval_required response |
| amountCents | integer | Override the USD cents charged (min 1 cent default) |
| description | string |
Pay-per-call LLM, no API key. Sends messages to Fuse chat completions; agentpay settles the standard x402 v2 BSV 402 from this wallet and returns the completion plus receiptUrl and txid. Models: fuse-fast (500 sats) or fuse-smart (2500 sats). Wallet limits, scoped keys, and trial budgets apply. Pass dryRun to quote without spending.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| ref | string | |
| model | string | Fuse model (default fuse-fast). fuse-fast = 500 sats, fuse-smart = 2500 sats. |
| dryRun | boolean | Quote + policy check only, no debit or settlement |
| messages * | array | OpenAI-style chat messages |
| approvalId | string | Approval id from a prior approval_required response |
| max_tokens | integer | |
| amountCents | integer | Override the USD cents charged (min 1 cent default) |
| description | string |
Extract typed values from messy text or receipts. Pays Fuse extract; agentpay settles the standard x402 v2 BSV 402 from this wallet. Prefer this over chat when you need structured fields with confidence scores and explicit nulls (p_null) instead of made-up answers. Types: text|number|date|time|datetime|duration|list|estimate|forecast (lists need items, e.g. "text"). fields is a name→{type} object. Tiers: S 3,500 sats (≤1,500 chars, ≤8 fields), M 15,000 (≤6,000 chars, ≤30 fields), L 50,000 (≤16,000 chars, ≤30 fields); images (base64 PNG/JPEG/WebP) are at least M. Oversized → 413, bad schema → 400. Returns answers, receipt, and txid. Pass dryRun to quote the tier and price without spending.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| ref | string | |
| state | string | Messy text, receipt, email, or notes. Required unless images are sent. |
| dryRun | boolean | Quote the extract tier (S/M/L) and price only, no debit or settlement |
| fields * | any | Fuse wire format: object mapping field names to {type, items?}. An array of {name, type} is also accepted. |
| images | array | Base64 PNG, JPEG, or WebP (or data URI). Remote URLs are rejected. Image requests are at least M. |
| approvalId | string | Approval id from a prior approval_required response |
| amountCents | integer |
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, and every child spend also counts against the parent's daily limit (fails with code parent_daily_limit when the parent cap would be exceeded); revoke it any time.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| name * | string | Worker name, e.g. scraper-1 |
| budgetCents | integer | Lifetime budget in USD cents (omit for no total cap) |
| allowedTools | array | Allowlist entries like serviceId:tool, serviceId:*, chat, extract, or fuse:fuse-fast |
| dailyLimitCents | integer | Per-day limit in USD cents |
| expiresInMinutes | integer | Key expiry (max 30 days) |
| approvalAboveCents | integer | Human approval threshold in cents |
{
"name": "mint_subagent",
"title": "Mint a sub-agent",
"description": "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, and every child spend also counts against the parent's daily limit (fails with code parent_daily_limit when the parent cap would be exceeded); revoke it any time.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"name": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Worker name, e.g. scraper-1"
},
"budgetCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Lifetime budget in USD cents (omit for no total cap)"
},
"allowedTools": {
"type": "array",
"items": {
"type": "string"
},
"description": "Allowlist entries like serviceId:tool, serviceId:*, chat, extract, or fuse:fuse-fast"
},
"dailyLimitCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Per-day limit in USD cents"
},
"expiresInMinutes": {
"type": "integer",
"maximum": 43200,
"minimum": 1,
"description": "Key expiry (max 30 days)"
},
"approvalAboveCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Human approval threshold in cents"
}
}
}
}List the child keys delegated by the current agent, with budget, spend, expiry, and status.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
{
"name": "list_subagents",
"title": "List sub-agents",
"description": "List the child keys delegated by the current agent, with budget, spend, expiry, and status.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
}
}
}
}Revoke a delegated child key immediately.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| agentId * | string | Sub-agent id from mint_subagent or list_subagents |
{
"name": "revoke_subagent",
"title": "Revoke a sub-agent",
"description": "Revoke a delegated child key immediately.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"agentId"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"agentId": {
"type": "string",
"description": "Sub-agent id from mint_subagent or list_subagents"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| sub | string | Claimant binding, e.g. workerPubKey for a bounty claim |
| days | integer | Window in days (default 30) |
{
"name": "get_attestation",
"title": "Get proof-of-spend attestation",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"sub": {
"type": "string",
"maxLength": 120,
"description": "Claimant binding, e.g. workerPubKey for a bounty claim"
},
"days": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Window in days (default 30)"
}
}
}
}Fetch a receipt by id.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| receiptId * | string |
{
"name": "get_receipt",
"title": "Get receipt",
"description": "Fetch a receipt by id.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"receiptId"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"receiptId": {
"type": "string"
}
}
}
}Recent wallet ledger events (top-ups, spends), newest first.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| limit | integer |
{
"name": "list_transactions",
"title": "List transactions",
"description": "Recent wallet ledger events (top-ups, spends), newest first.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
}
}
}
}Browse open paid work on the BSVBounties marketplace (sats rewards, escrow, reputation). Free — no key required.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| status | string | Bounty status filter (default open) |
| category | string | Category filter, e.g. dev, research, content, data, design |
{
"name": "list_bounties",
"title": "List bounties",
"description": "Browse open paid work on the BSVBounties marketplace (sats rewards, escrow, reputation). Free — no key required.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"open",
"claimed",
"submitted",
"paid",
"refunded"
],
"type": "string",
"description": "Bounty status filter (default open)"
},
"category": {
"type": "string",
"description": "Category filter, e.g. dev, research, content, data, design"
}
}
}
}Full detail for one BSVBounties listing: requirements, amount, acceptance spec, status, escrow state.
| Parameter | Type | Description |
|---|---|---|
| bountyId * | string | Bounty id from list_bounties |
{
"name": "get_bounty",
"title": "Get bounty",
"description": "Full detail for one BSVBounties listing: requirements, amount, acceptance spec, status, escrow state.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bountyId"
],
"properties": {
"bountyId": {
"type": "string",
"description": "Bounty id from list_bounties"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| bountyId * | string | Bounty id from list_bounties |
| workerPubKey | string | BSV worker identity key |
| payoutAddress | string | Optional BSV P2PKH payout address for direct sats |
| workerAccount | integer | BSVBounties account # doing the work |
{
"name": "claim_bounty",
"title": "Claim a bounty",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bountyId"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"bountyId": {
"type": "string",
"description": "Bounty id from list_bounties"
},
"workerPubKey": {
"type": "string",
"description": "BSV worker identity key"
},
"payoutAddress": {
"type": "string",
"description": "Optional BSV P2PKH payout address for direct sats"
},
"workerAccount": {
"type": "integer",
"maximum": 9007199254740991,
"description": "BSVBounties account # doing the work",
"exclusiveMinimum": 0
}
}
}
}Submit your work for a bounty you claimed through agentpay. Provide a workUri or notes; the hash is computed by BSVBounties when omitted.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| notes | string | Summary for the poster/verifier — include the payout address from claim_bounty |
| workUri | string | URL of the deliverable |
| bountyId * | string | |
| workHash | string | sha256 hex of the work, if you compute it yourself |
| milestoneIndex | integer |
{
"name": "submit_work",
"title": "Submit work",
"description": "Submit your work for a bounty you claimed through agentpay. Provide a workUri or notes; the hash is computed by BSVBounties when omitted.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bountyId"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"notes": {
"type": "string",
"description": "Summary for the poster/verifier — include the payout address from claim_bounty"
},
"workUri": {
"type": "string",
"description": "URL of the deliverable"
},
"bountyId": {
"type": "string"
},
"workHash": {
"type": "string",
"description": "sha256 hex of the work, if you compute it yourself"
},
"milestoneIndex": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| title * | string | |
| category | string | dev, research, content, data, design, other (default other) |
| deadline | integer | Unix seconds; enables deadline refunds |
| amountSats * | integer | Reward in sats; escrowed on-chain |
| description * | string | |
| payoutAddress | string | Optional BSV P2PKH address for the worker's sats (default: worker's agentpay balance) |
{
"name": "post_bounty",
"title": "Post a funded bounty",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title",
"description",
"amountSats"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"title": {
"type": "string",
"maxLength": 120
},
"category": {
"type": "string",
"description": "dev, research, content, data, design, other (default other)"
},
"deadline": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unix seconds; enables deadline refunds"
},
"amountSats": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reward in sats; escrowed on-chain",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"maxLength": 2000
},
"payoutAddress": {
"type": "string",
"description": "Optional BSV P2PKH address for the worker's sats (default: worker's agentpay balance)"
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
| outcome * | string | one of ["paid","refunded"] |
| bountyId * | string |
{
"name": "settle_bounty",
"title": "Settle a posted bounty",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bountyId",
"outcome"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"outcome": {
"enum": [
"paid",
"refunded"
],
"type": "string"
},
"bountyId": {
"type": "string"
}
}
}
}List agentpay-funded bounties posted by this wallet: amount, escrow address, funding/payout/refund txids, and any pending error.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
{
"name": "my_escrows",
"title": "My bounty escrows",
"description": "List agentpay-funded bounties posted by this wallet: amount, escrow address, funding/payout/refund txids, and any pending error.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name | string | Wallet name, e.g. trial-bot |
{
"name": "claim_trial",
"title": "Claim a trial wallet",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 60,
"description": "Wallet name, e.g. trial-bot"
}
}
}
}List bounties this wallet has claimed through agentpay, with status and credited amount.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
{
"name": "my_bounties",
"title": "My bounties",
"description": "List bounties this wallet has claimed through agentpay, with status and credited amount.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
}
}
}
}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.
| Parameter | Type | Description |
|---|---|---|
| key | string | Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer. |
{
"name": "onboard",
"title": "Onboard this agent",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
}
}
}
}agentpay is a prepaid USD wallet for AI agents on Cloudflare. Pay-per-call LLM (chat → Fuse) and typed extract (extract → Fuse) with no API key, plus x402/BSV payments for registry APIs. Human dashboard: https://entangleit.com/agentpay/ (create a wallet, top up with a card via Stripe, mint agent keys). Agents authenticate with a scoped key (agp_…). Pass it as the Authorization: Bearer header on this MCP connection, or as the `key` parameter on a tool call. New agents call onboard first: it inspects balance, claims, and history, then returns the single next action. No key yet: claim_trial mints a pre-funded trial wallet + key (one per IP per day, sized for ~50 fuse-fast calls). Full playbook: https://entangleit.com/api/agentpay/skill · llms.txt: https://entangleit.com/api/agentpay/llms.txt. Public tools: list_services and service_quote read the x402market registry (paid x402/BSV APIs) and live 402 challenges. claim_trial mints a pre-funded trial wallet + key with no human needed (operator-gated, one per IP per day). Wallet tools: get_balance, list_transactions, get_receipt, send. LLM: chat {model, messages} calls Fuse chat completions (https://entangleit.com/fuse/v1/chat/completions). No Fuse API key — agentpay pays the standard x402 v2 402 in sats and returns the completion plus receiptUrl and txid. Models: fuse-fast (500 sats) and fuse-smart (2500 sats). Wallet limits, scoped keys, and trial budgets apply. Extract: extract {state, fields} pays Fuse extract (https://entangleit.com/fuse/v1/extract) for typed values from messy text or receipts. Use extract instead of chat when you need structured fields with confidence scores and explicit nulls (p_null) rather than made-up answers. fields is a name→{type} object. Field types: text|number|date|time|datetime|duration|list|estimate|forecast (lists need items, e.g. "text"). Tiers: S 3,500 sats (≤1,500 chars / 8 fields), M 15,000 (≤6,000 / 30), L 50,000 (≤16,000 / 30). Images must be base64 PNG/JPEG/WebP (or data URI) and are at least M. Oversized → 413, bad schema → 400. Returns answers, receipt, and txid. dryRun quotes the tier and price without paying. Spending: spend debits the wallet and writes a receipt. send pays a BSV P2PKH address on-chain (settlement=live, txid is a BSV tx) or an agentpay wallet id apw_… as an internal ledger transfer (settlement=internal, txid is a receipt id). pay_service quotes a registry seller, settles the BSV x402 challenge (legacy single-object or standard v2 accepts[]) from the site wallet, and returns the seller's result — all in one call. pay_service takes params (tool arguments) and optional amountCents. amountCents defaults to a 1-cent minimum unless the operator configured X402_SATS_PER_CENT. Per-agent policy: allowedTools restricts pay_service to entries like serviceId:tool or serviceId:* (empty = all); generic spend needs the "spend" entry; send needs "spend", "agent_send", or "*"; chat needs "chat", "fuse:*", or fuse:<model>; extract needs "extract", "fuse:extract", "fuse:fuse-extract", or "fuse:*". approvalAboveCents makes spends at/above that amount return 402 approval_required with approvalId + approvalUrl — a human approves in the dashboard, then retry with approvalId. Plans: wallets start on Free (3 agent keys, daily limits up to $50/agent). Pro ($29/mo) raises that to 25 keys, $1,000/agent daily limits, and CSV export. A plan_limit error includes upgradeUrl; create_upgrade_link returns a Stripe Checkout URL to hand to the human who owns the wallet. Delegation: a top-level agent can mint_subagent for each worker with its own lifetime budget, expiry, daily limit, and allowlist — then list_subagents and revoke_subagent. Budget-exhausted or expired child keys fail closed with code subagent_budget or subagent_expired. Cascading budgets: every child spend also counts against the parent's daily limit (code parent_daily_limit when the parent cap would be exceeded), so a parent cannot dodge its cap by delegating. Reputation: get_attestation ret
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| bountyAccount | integer | BSVBounties account # for trust fast-path |
{
"name": "pay_service",
"title": "Pay a service",
"description": "One call for paid registry tools: quotes the seller's x402 challenge (legacy single-object or standard v2 accepts[] — BSV exact only), 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. For pay-per-call LLM with no API key, use chat; for typed values from messy text or receipts, use extract. Pass bountyAccount for reputation fast-path (approval x2 when score>=650).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"serviceId",
"tool"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"ref": {
"type": "string"
},
"tool": {
"type": "string",
"description": "Tool name on that service"
},
"dryRun": {
"type": "boolean",
"description": "Sandbox: quote + policy check only, no debit or settlement"
},
"params": {
"type": "object",
"description": "Tool arguments (body for POST, query for GET)",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"serviceId": {
"type": "string",
"description": "Registry service id (from list_services)"
},
"approvalId": {
"type": "string",
"description": "Approval id from a prior approval_required response"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Override the USD cents charged (min 1 cent default)"
},
"description": {
"type": "string",
"maxLength": 200
},
"bountyAccount": {
"type": "integer",
"maximum": 9007199254740991,
"description": "BSVBounties account # for trust fast-path",
"exclusiveMinimum": 0
}
}
}
}{
"name": "chat",
"title": "Pay-per-call LLM",
"description": "Pay-per-call LLM, no API key. Sends messages to Fuse chat completions; agentpay settles the standard x402 v2 BSV 402 from this wallet and returns the completion plus receiptUrl and txid. Models: fuse-fast (500 sats) or fuse-smart (2500 sats). Wallet limits, scoped keys, and trial budgets apply. Pass dryRun to quote without spending.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"messages"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"ref": {
"type": "string"
},
"model": {
"enum": [
"fuse-fast",
"fuse-smart"
],
"type": "string",
"description": "Fuse model (default fuse-fast). fuse-fast = 500 sats, fuse-smart = 2500 sats."
},
"dryRun": {
"type": "boolean",
"description": "Quote + policy check only, no debit or settlement"
},
"messages": {
"type": "array",
"items": {
"type": "object",
"required": [
"role",
"content"
],
"properties": {
"role": {
"enum": [
"system",
"user",
"assistant"
],
"type": "string"
},
"content": {
"type": "string",
"minLength": 1
}
}
},
"minItems": 1,
"description": "OpenAI-style chat messages"
},
"approvalId": {
"type": "string",
"description": "Approval id from a prior approval_required response"
},
"max_tokens": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Override the USD cents charged (min 1 cent default)"
},
"description": {
"type": "string",
"maxLength": 200
}
}
}
}| Override the USD cents charged (min 1 cent default) |
| description | string |
| reference_date | string | YYYY-MM-DD (or ISO datetime) used to resolve relative dates like 'yesterday' |
{
"name": "extract",
"title": "Extract typed fields",
"description": "Extract typed values from messy text or receipts. Pays Fuse extract; agentpay settles the standard x402 v2 BSV 402 from this wallet. Prefer this over chat when you need structured fields with confidence scores and explicit nulls (p_null) instead of made-up answers. Types: text|number|date|time|datetime|duration|list|estimate|forecast (lists need items, e.g. \"text\"). fields is a name→{type} object. Tiers: S 3,500 sats (≤1,500 chars, ≤8 fields), M 15,000 (≤6,000 chars, ≤30 fields), L 50,000 (≤16,000 chars, ≤30 fields); images (base64 PNG/JPEG/WebP) are at least M. Oversized → 413, bad schema → 400. Returns answers, receipt, and txid. Pass dryRun to quote the tier and price without spending.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"fields"
],
"properties": {
"key": {
"type": "string",
"description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer."
},
"ref": {
"type": "string"
},
"state": {
"type": "string",
"description": "Messy text, receipt, email, or notes. Required unless images are sent."
},
"dryRun": {
"type": "boolean",
"description": "Quote the extract tier (S/M/L) and price only, no debit or settlement"
},
"fields": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"text",
"number",
"date",
"time",
"datetime",
"duration",
"list",
"estimate",
"forecast"
],
"type": "string"
},
"items": {
"anyOf": [
{
"enum": [
"text",
"number",
"date",
"time",
"datetime",
"duration",
"list",
"estimate",
"forecast"
],
"type": "string"
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"text",
"number",
"date",
"time",
"datetime",
"duration",
"list",
"estimate",
"forecast"
],
"type": "string"
},
"description": {
"type": "string"
}
}
}
],
"description": "Required when type is list, e.g. \"text\""
},
"description": {
"type": "string"
}
}
}
},
{
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"type"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"type": {
"enum": [
"text",
"number",
"date",
"time",
"datetime",
"duration",
"list",
"estimate",
"forecast"
],
"type": "string"
},
"items": {
"anyOf": [
{
"enum": [
"text",
"number",
"date",
"time",
"datetime",
"duration",
"list",
"estimate",
"forecast"
],
"type": "string"
},
{
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"text",
"number",
"date",
"time",
"datetime",
"duration",
"list",
"estimate",
"forecast"
],
"type": "string"
},
"description": {
"type": "string"
}
}
}
]
},
"description": {
"type": "string"
}
}
},
"minItems": 1
}
],
"description": "Fuse wire format: object mapping field names to {type, items?}. An array of {name, type} is also accepted."
},
"images": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Base64 PNG, JPEG, or WebP (or data URI). Remote URLs are rejected. Image requests are at least M."
},
"approvalId": {
"type": "string",
"description": "Approval id from a prior approval_required response"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Override the USD cents charged (min 1 cent default)"
},
"description": {
"type": "string",
"maxLength": 200
},
"reference_date": {
"type": "string",
"description": "YYYY-MM-DD (or ISO datetime) used to resolve relative dates like 'yesterday'"
}
}
}
}