CtrlK
BlogDocsLog inGet started
Tessl Logo

agentcash-wallet

Manage your agentcash wallet and call any x402-protected API with automatic payment. No API keys, no subscriptions — just a funded wallet (USDC on Base). USE FOR: - Checking wallet balance before API calls - Redeeming invite codes for free credits - Getting deposit address for USDC - Discovering endpoints and pricing on any x402-protected origin - Making paid API requests via the agentcash CLI - Troubleshooting payment failures TRIGGERS: - "balance", "wallet", "funds", "credits", "x402" - "redeem", "invite code", "promo code" - "deposit", "add funds", "top up" - "discover", "endpoints", "what APIs", "pricing" - "insufficient balance", "payment failed"

Install with Tessl CLI

npx tessl i github:Merit-Systems/agentcash-skills --skill agentcash-wallet
What are skills?

100

Review — 100%

Does it follow best practices?

Validation — 11 / 11 Passed

Validation for skill structure

SKILL.md
Review
Evals

agentcash Wallet & Paid APIs

Call any x402-protected API with automatic payment. Payment is the authentication — no API keys or subscriptions needed.

Setup

If the agentcash CLI is not yet installed, see rules/getting-started.md for installation and wallet setup.

Wallet Management

Your wallet is auto-created on first use and stored at ~/.agentcash/wallet.json.

Check Balance

npx agentcash wallet info

Returns wallet address, USDC balance, and deposit link. Always check before expensive operations.

Redeem Invite Code

npx agentcash wallet redeem YOUR_CODE

One-time use per code. Credits added instantly. Run npx agentcash wallet info after to verify.

Deposit USDC

  1. Get your wallet address via npx agentcash wallet info
  2. Send USDC on Base network (eip155:8453) to that address
  3. Or use the deposit UI: https://x402scan.com/mcp/deposit/<wallet-address>

Important: Only Base network USDC. Other networks or tokens will be lost.

Calling Paid APIs

1. Discover endpoints

npx agentcash discover https://stableenrich.dev

Returns all endpoints, pricing, and usage instructions. Read the instructions field — it has critical endpoint-specific guidance.

2. Check schema (optional)

npx agentcash check https://stableenrich.dev/api/apollo/people-search

Returns full request/response JSON schemas and pricing for a specific endpoint.

3. Make a paid request

npx agentcash fetch https://stableenrich.dev/api/apollo/people-search -m POST -b '{"person_titles": ["CEO"], "person_locations": ["San Francisco"]}'

Payment is automatic: sends request, gets 402 challenge, signs USDC payment, retries with credential, returns result. Payments settle only on success (2xx) — failed requests cost nothing.

Available Services

OriginServiceWhat it does
https://stableenrich.devStableEnrichResearch APIs: Apollo (people/org), Exa (web search), Firecrawl (scraping), Grok (X/Twitter), Google Maps, Clado (LinkedIn), Serper (news/shopping), WhitePages, Reddit, Hunter (email verification), Influencer enrichment
https://stableupload.devStableUploadPay-per-upload file hosting. 10MB/$0.02, 100MB/$0.20, 1GB/$2.00. 6-month TTL
https://stablestudio.devStableStudioAI image/video generation: GPT Image, Flux, Grok, Nano Banana, Sora, Veo, Seedance, Wan
https://stablesocial.devStableSocialSocial media data: TikTok, Instagram, X/Twitter, Facebook, Reddit, LinkedIn. $0.06/call, async two-step
https://stableemail.devStableEmailSend emails ($0.02), forwarding inboxes ($1/mo), custom subdomains ($5)
https://stablephone.devStablePhoneAI phone calls ($0.54), phone numbers ($20), top-ups ($15)
https://stablejobs.devStableJobsJob search via Coresignal

Run npx agentcash discover <origin> on any origin to see its full endpoint catalog.

Quick Reference

TaskCommand
Check balancenpx agentcash wallet info
Redeem codenpx agentcash wallet redeem <code>
Discover endpointsnpx agentcash discover <url>
Check pricing/schemanpx agentcash check <url>
Paid POST requestnpx agentcash fetch <url> -m POST -b '{...}'
Paid GET requestnpx agentcash fetch <url>

Tips

  • Always discover first — the instructions field has critical endpoint-specific patterns and required parameters.
  • Payments settle only on success (2xx) — failed requests cost nothing.
  • Use npx agentcash check <url> when unsure about request/response format.
  • Add --format json for machine-readable output, --format pretty for human-readable.
  • Add -v for verbose output to see payment details.
  • Network: Base (eip155:8453), Currency: USDC.

Troubleshooting

IssueSolution
"Command not found"Run npm install -g agentcash
"Insufficient balance"Check balance, deposit USDC or redeem invite code
"Payment failed"Transient error — retry the request
"Invalid invite code"Code already used or doesn't exist
Balance not updatingWait for Base network confirmation (~2 sec)
Repository
Merit-Systems/agentcash-skills
Commit

fe3e7ab

Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill