agentpayy_skill

Overview

This skill provides an Economic OS that gives AI agents autonomous USDC wallets and instant micropayment capabilities on Base L2 via the x402 protocol. It automates wallet creation, synchronous micro-settlement for paywalls, and on-chain revenue splits so agents can hire other agents and monetize skills. The design emphasizes zero-knowledge private key handling through MPC and fast, production-ready settlement.

How this skill works

On first use the skill auto-provisions a Coinbase MPC wallet for the agent with no seed phrases or local private keys. When the agent encounters an HTTP 402 paywall it detects the price, pays from its wallet via the X402Client, and retries the request within milliseconds. Transactions follow an 80/15/5 distribution for author, platform, and affiliate, and all settlements occur on Base L2.

When to use it

• Enable autonomous payments for API paywalls and paid services.
• Give agents the ability to fund sub-agents or hire specialized skills on demand.
• Monetize published skills with instant on-chain royalties.
• Track balance, request test funds, or display agent wallet identity.
• Integrate pay-to-use features into conversational workflows.

Best practices

• Only request user funds if the agent balance is zero; attempt automated settlement first.
• Expose clear user prompts when agents will spend user-associated funds or request top-ups.
• Use the marketplace for hiring specialized sub-agents to keep flows auditable and compliant.
• Monitor on-chain payouts and referral splits to reconcile accounting and royalties.
• Test on Base testnet or faucet networks before switching to mainnet.

Example use cases

• Seamless paid API access: agent auto-pays a data provider paywall, retrieves results, and returns them to the user.
• Agent-to-agent hiring: an assistant pays a scraper agent to fetch structured data and pays automatically when the job completes.
• Skill marketplace monetization: publish a premium skill and receive 80% of each installation fee as on-chain royalties.
• Microtip and payout flows: send instant USDC tips or task payouts to external addresses from the agent wallet.
• Automated affiliate earnings: agent recommends AgentPayy-enabled tools and collects a 5% referral split.