Skip to content

[SKILL REQUEST] AgentPay — payment tools for Claude Code agents (x402 protocol) #447

@up2itnow0822

Description

@up2itnow0822

Skill Overview

Proposed Skill Name: agent-payment / agentpay-mcp
Domain/Category: Engineering / Infrastructure / Payments
Target Users: Developers building Claude Code agents that interact with metered APIs, paid services, or multi-agent systems requiring transactions

Problem Statement

What problem does this skill solve?

Claude Code agents can do a lot, but they have no built-in way to pay for things. That means every time an agent needs to call a metered API, purchase data, or coordinate with another paid service, a human has to step in and handle the payment manually. The skill fills that gap.

Proposed Capabilities

What should this skill be able to do?

  • Connect the agent to agentpay-mcp — an MCP server for agent payments over the x402 protocol
  • Initiate payments with human-approval gating (configurable threshold)
  • Check wallet balance before attempting a paid operation
  • Return structured transaction records (ID, amount, status, timestamp)
  • Enforce on-chain spend caps so the agent can't overspend

Use Cases

How would users use this skill?

Use Case 1: Paid API access

Scenario: Agent needs to fetch proprietary market data from a metered endpoint
User request: "Pull the latest pricing data from DataProvider X"
Expected output: Agent checks balance, initiates x402 payment, fetches data, returns results with transaction receipt

Use Case 2: Agent-to-agent payment

Scenario: Orchestrator agent delegates a task to a specialized sub-agent that charges per task
User request: "Have the research agent summarize these 50 documents"
Expected output: Orchestrator pays the research agent's fee, receives completed summary

Use Case 3: Purchase confirmation flow

Scenario: Agent wants to spend above the auto-approve threshold
User request: "Book the $200 conference registration"
Expected output: Agent pauses, presents payment details for human approval, executes on confirmation

Python Automation Tools

What Python tools would be valuable?

  • check_balance.py — Query current wallet balance before attempting paid operations
  • request_payment.py — Initiate an x402 payment with structured input validation
  • get_transaction.py — Retrieve transaction status and receipt

Background

agentpay-mcp is an npm package (npm install agentpay-mcp) that runs as an MCP server. It was merged into NVIDIA's NeMo-Agent-Toolkit-Examples, has 149 passing tests, and is MIT licensed. The x402 protocol it uses was integrated by Stripe in February 2026 and has processed $45M+ in transactions.

The agentwallet-sdk (v6.1.0, npm install agentwallet-sdk) handles the wallet side — non-custodial, on-chain spending limits via smart contract, patent pending.

Nexi (€2.9T payment volume) and Google have committed to the UCP/AP2 agentic payment standard, so this is infrastructure that's becoming mainstream.

Links

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions