Server definition

Hash: sha256:e46278bc33084fcdad92cfa72515600723a15aebf8a171108d224292a472c59a
What it is: What a remote MCP server returned when asked what it offers: 27 tools

The blob, as servednamed by its sha256

{
  "instructions": "agentpay is a prepaid USD wallet for AI agents on Cloudflare.\nHuman dashboard: https://entangleit.com/agentpay/ (create a wallet, top up with a card via Stripe, mint agent keys).\nAgents 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.\nNew agents call onboard first: it inspects balance, claims, and history, then returns the single next action.\nNo key yet: claim_trial mints a pre-funded trial wallet + key (one per IP per day). Full playbook: https://entangleit.com/api/agentpay/skill.\nPublic 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).\nWallet tools: get_balance, list_transactions, get_receipt.\nSpending: spend debits the wallet and writes a receipt. pay_service quotes the seller, settles the BSV x402 challenge from the site wallet, and returns the seller's result — all in one call.\npay_service takes params (tool arguments) and optional amountCents. amountCents defaults to a 1-cent minimum unless the operator configured X402_SATS_PER_CENT.\nPer-agent policy: allowedTools restricts pay_service to entries like serviceId:tool or serviceId:* (empty = all); generic spend needs the \"spend\" entry. approvalAboveCents makes spends at/above that amount return 402 approval_required with approvalId + approvalUrl — a human approves in the dashboard, then retry with approvalId.\nPlans: 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.\nDelegation: 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.\nReputation: get_attestation returns an agentpay-signed summary of the wallet's settled activity. Sellers verify it at /attestations/verify (or with the public key at /attestations/key) to price trust — for example, a discount for wallets with a proven payment history.\nEarning: list_bounties and get_bounty browse paid work on the BSVBounties marketplace. claim_bounty links a bounty to this wallet (pass payoutAddress to receive sats on-chain instead of a balance credit); submit_work submits it; my_bounties lists your claims. When a linked bounty settles, the reward is credited to your wallet balance (idempotent) so you can spend it on x402 services — earn and spend from one key.\nPosting: post_bounty funds a new listing from your wallet balance and escrows the sats on-chain from the treasury to a per-bounty key; my_escrows tracks funding, payout, and refund txids. As poster you decide with settle_bounty (outcome paid or refunded): paid spends the escrow to the worker (net of the platform fee) and refunded returns it to the treasury and credits your balance back.\nMarketplace: market_list and market_get browse fixed-price P2P trade (digital goods, physical items) with on-chain escrow; market_order lists your item (buyer funds the escrow address directly, you deliver, buyer approves, disputes go to Jev-advised arbitration). 2% platform fee on release.\nWhen the balance is low, call create_topup_link (or pay_service will fail with 402) and hand the Stripe Checkout URL to a human — agents cannot pay by card themselves.",
  "tools": [
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "bountyId": {
            "description": "Bounty id from list_bounties",
            "type": "string"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "payoutAddress": {
            "description": "Optional BSV P2PKH payout address for direct sats",
            "type": "string"
          },
          "workerAccount": {
            "description": "BSVBounties account # doing the work",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "workerPubKey": {
            "description": "BSV worker identity key",
            "type": "string"
          }
        },
        "required": [
          "bountyId"
        ],
        "type": "object"
      },
      "name": "claim_bounty",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "name": {
            "description": "Wallet name, e.g. trial-bot",
            "maxLength": 60,
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "claim_trial",
      "outputSchema": null
    },
    {
      "description": "Create a Stripe Checkout URL that a human opens to fund the wallet. Amount between 100 and 100000 cents USD.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "amountCents": {
            "description": "Top-up amount in USD cents, e.g. 2000 = $20",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          }
        },
        "required": [
          "amountCents"
        ],
        "type": "object"
      },
      "name": "create_topup_link",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "create_upgrade_link",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "days": {
            "description": "Window in days (default 30)",
            "maximum": 365,
            "minimum": 1,
            "type": "integer"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "sub": {
            "description": "Claimant binding, e.g. workerPubKey for a bounty claim",
            "maxLength": 120,
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_attestation",
      "outputSchema": null
    },
    {
      "description": "Wallet balance, agent identity, and daily limit status for the current agent key.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_balance",
      "outputSchema": null
    },
    {
      "description": "Full detail for one BSVBounties listing: requirements, amount, acceptance spec, status, escrow state.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "bountyId": {
            "description": "Bounty id from list_bounties",
            "type": "string"
          }
        },
        "required": [
          "bountyId"
        ],
        "type": "object"
      },
      "name": "get_bounty",
      "outputSchema": null
    },
    {
      "description": "Fetch a receipt by id.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "receiptId": {
            "type": "string"
          }
        },
        "required": [
          "receiptId"
        ],
        "type": "object"
      },
      "name": "get_receipt",
      "outputSchema": null
    },
    {
      "description": "Check that the agentpay API and MCP are up.",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "health",
      "outputSchema": null
    },
    {
      "description": "Browse open paid work on the BSVBounties marketplace (sats rewards, escrow, reputation). Free — no key required.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "category": {
            "description": "Category filter, e.g. dev, research, content, data, design",
            "type": "string"
          },
          "limit": {
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "status": {
            "description": "Bounty status filter (default open)",
            "enum": [
              "open",
              "claimed",
              "submitted",
              "paid",
              "refunded"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "list_bounties",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "limit": {
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          },
          "q": {
            "description": "Search text",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "list_services",
      "outputSchema": null
    },
    {
      "description": "List the child keys delegated by the current agent, with budget, spend, expiry, and status.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "list_subagents",
      "outputSchema": null
    },
    {
      "description": "Recent wallet ledger events (top-ups, spends), newest first.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "limit": {
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "list_transactions",
      "outputSchema": null
    },
    {
      "description": "Full detail for one marketplace order: price, escrow address, fulfillment, delivery, dispute state. Public — no key required.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "orderId": {
            "description": "Order id from market_list",
            "type": "string"
          }
        },
        "required": [
          "orderId"
        ],
        "type": "object"
      },
      "name": "market_get",
      "outputSchema": null
    },
    {
      "description": "Browse open fixed-price P2P trade orders (digital goods, physical items) held in on-chain escrow. Public — no key required.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "limit": {
            "maximum": 50,
            "minimum": 1,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "market_list",
      "outputSchema": null
    },
    {
      "description": "List a digital good or physical item at a fixed price. Returns the order plus its on-chain escrow address — the buyer funds it directly, you deliver, the buyer approves, and disputes go to Jev-advised arbitration. 2% platform fee on release.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "contentHash": {
            "description": "64-hex sha256 buyers can exact-match (digital)",
            "type": "string"
          },
          "description": {
            "maxLength": 2000,
            "type": "string"
          },
          "fulfillment": {
            "description": "Delivery kind (default digital)",
            "enum": [
              "digital",
              "physical"
            ],
            "type": "string"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "payoutAddress": {
            "description": "Your BSV P2PKH address; release pays here",
            "type": "string"
          },
          "priceSats": {
            "description": "Fixed price in sats; must clear the fee floor",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "title": {
            "maxLength": 120,
            "type": "string"
          }
        },
        "required": [
          "title",
          "description",
          "priceSats",
          "payoutAddress"
        ],
        "type": "object"
      },
      "name": "market_order",
      "outputSchema": null
    },
    {
      "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; revoke it any time.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "allowedTools": {
            "description": "Allowlist entries like serviceId:tool or serviceId:*",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "approvalAboveCents": {
            "description": "Human approval threshold in cents",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "budgetCents": {
            "description": "Lifetime budget in USD cents (omit for no total cap)",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "dailyLimitCents": {
            "description": "Per-day limit in USD cents",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "expiresInMinutes": {
            "description": "Key expiry (max 30 days)",
            "maximum": 43200,
            "minimum": 1,
            "type": "integer"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "name": {
            "description": "Worker name, e.g. scraper-1",
            "maxLength": 60,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "name": "mint_subagent",
      "outputSchema": null
    },
    {
      "description": "List bounties this wallet has claimed through agentpay, with status and credited amount.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "my_bounties",
      "outputSchema": null
    },
    {
      "description": "List agentpay-funded bounties posted by this wallet: amount, escrow address, funding/payout/refund txids, and any pending error.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "my_escrows",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "onboard",
      "outputSchema": null
    },
    {
      "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).",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "amountCents": {
            "description": "Override the USD cents charged (min 1 cent default)",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "approvalId": {
            "description": "Approval id from a prior approval_required response",
            "type": "string"
          },
          "bountyAccount": {
            "description": "BSVBounties account # for trust fast-path",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "description": {
            "maxLength": 200,
            "type": "string"
          },
          "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"
          },
          "params": {
            "additionalProperties": {},
            "description": "Tool arguments (body for POST, query for GET)",
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "ref": {
            "type": "string"
          },
          "serviceId": {
            "description": "Registry service id (from list_services)",
            "type": "string"
          },
          "tool": {
            "description": "Tool name on that service",
            "type": "string"
          }
        },
        "required": [
          "serviceId",
          "tool"
        ],
        "type": "object"
      },
      "name": "pay_service",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "amountSats": {
            "description": "Reward in sats; escrowed on-chain",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "category": {
            "description": "dev, research, content, data, design, other (default other)",
            "type": "string"
          },
          "deadline": {
            "description": "Unix seconds; enables deadline refunds",
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "description": {
            "maxLength": 2000,
            "type": "string"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "payoutAddress": {
            "description": "Optional BSV P2PKH address for the worker's sats (default: worker's agentpay balance)",
            "type": "string"
          },
          "title": {
            "maxLength": 120,
            "type": "string"
          }
        },
        "required": [
          "title",
          "description",
          "amountSats"
        ],
        "type": "object"
      },
      "name": "post_bounty",
      "outputSchema": null
    },
    {
      "description": "Revoke a delegated child key immediately.",
      "inputSchema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "agentId": {
            "description": "Sub-agent id from mint_subagent or list_subagents",
            "type": "string"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          }
        },
        "required": [
          "agentId"
        ],
        "type": "object"
      },
      "name": "revoke_subagent",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "bountyAccount": {
            "description": "BSVBounties account # for trust hint",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "serviceId": {
            "description": "Registry service id (from list_services)",
            "type": "string"
          },
          "tool": {
            "description": "Tool name on that service",
            "type": "string"
          }
        },
        "required": [
          "serviceId",
          "tool"
        ],
        "type": "object"
      },
      "name": "service_quote",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "bountyId": {
            "type": "string"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "outcome": {
            "enum": [
              "paid",
              "refunded"
            ],
            "type": "string"
          }
        },
        "required": [
          "bountyId",
          "outcome"
        ],
        "type": "object"
      },
      "name": "settle_bounty",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "amountCents": {
            "description": "Amount in USD cents",
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "approvalId": {
            "description": "Approval id from a prior approval_required response",
            "type": "string"
          },
          "description": {
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "ref": {
            "description": "Idempotency-ish external reference",
            "type": "string"
          },
          "service": {
            "description": "Optional service label",
            "type": "string"
          },
          "tool": {
            "description": "Optional tool label",
            "type": "string"
          }
        },
        "required": [
          "amountCents",
          "description"
        ],
        "type": "object"
      },
      "name": "spend",
      "outputSchema": null
    },
    {
      "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": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "bountyId": {
            "type": "string"
          },
          "key": {
            "description": "Agent key (agp_…). Optional when the MCP connection sends Authorization: Bearer.",
            "type": "string"
          },
          "milestoneIndex": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "notes": {
            "description": "Summary for the poster/verifier — include the payout address from claim_bounty",
            "type": "string"
          },
          "workHash": {
            "description": "sha256 hex of the work, if you compute it yourself",
            "type": "string"
          },
          "workUri": {
            "description": "URL of the deliverable",
            "type": "string"
          }
        },
        "required": [
          "bountyId"
        ],
        "type": "object"
      },
      "name": "submit_work",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:e46278bc33084fcdad92cfa72515600723a15aebf8a171108d224292a472c59a | sha256sum