agentcash-wallet
Pay-per-call x402/MPP APIs (USDC on Base, Solana, Tempo). No API keys—wallet pays per request. If the task matches a SERVICES origin below, SKIP search and go straight to discover → fetch. Only search when NO listed origin fits. SERVICES: stableenrich (people/company, web search, scraping, Maps, LinkedIn, email verify, news), stablesocial (TikTok, Instagram, YouTube, Facebook, Reddit, LinkedIn, GitHub), stablestudio (AI image/video), stableupload (file/site hosting), stableemail (email, inboxes, subdomains), stablephone (AI calls, phone numbers), stablejobs (jobs), stabletravel (travel), stablebrowser (browser automation). TRIGGERS: research, enrich, scrape, search the web, generate image, video, social media, send email, phone call, travel, jobs, find contact, find API, x402, mpp, agentcash
How do I install this agent skill?
npx skills add https://github.com/merit-systems/agentcash-skills --skill agentcash-walletIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill installs a remote MCP tool via npx and processes instructions from external API endpoints, which creates a surface for indirect prompt injection where remote content could influence agent behavior.
- Socketwarn
1 alert: gptAnomaly
- Snykwarn
Risk: MEDIUM · 3 issues
- Runlayerpass
1/2 files flagged
What does this agent skill do?
AgentCash Wallet & Paid APIs
Call any x402-protected API with automatic wallet authentication and payment. No API keys or subscriptions needed.
Setup
If the agentcash MCP 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
agentcash.get_balance()
Returns total USDC balance across supported networks. Use this before paid calls to confirm funds are available.
Redeem Invite Code
agentcash.redeem_invite(code="YOUR_CODE")
One-time use per code. Credits added instantly. Run agentcash.get_balance() after to verify.
Deposit USDC
- Call
agentcash.list_accounts()to get per-network wallet addresses and deposit links - Send USDC on Base network (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) to the matching address
- Or open the returned deposit link for the selected network
Important: Only Base or Solana network USDC. Other networks or tokens will be lost.
Calling Paid APIs
1. Pick an origin — or search
Check the Available Services table belowfirst. If any origin clearly covers the task, skip search entirely and jump to step 2 (discover). Examples:
| Task | Origin (skip search) |
|---|---|
| Look up a person or company | stableenrich.dev |
| Generate an image or video | stablestudio.dev |
| Get Instagram/TikTok data | stablesocial.dev |
| Send an email | stableemail.dev |
| Upload a file | stableupload.dev |
Only use search when none of the listed origins fit:
agentcash.search(query="send physical mail")
Returns matching origins with endpoints and pricing (the top match often includes schema so you can call fetch immediately).
CLI equivalent: npx agentcash@latest search "<query>".
2. Discover endpoints
agentcash.discover_api_endpoints(url="https://stableenrich.dev")
Returns all endpoints, pricing, and usage instructions. Read the instructions field — it has critical endpoint-specific guidance.
3. Check schema (optional)
agentcash.check_endpoint_schema(url="https://stableenrich.dev/api/fullenrich/people-search")
Returns full request/response JSON schemas and pricing for a specific endpoint.
4. Make a paid request
agentcash.fetch(
url="https://stableenrich.dev/api/fullenrich/people-search",
method="POST",
body={
"current_company_domains": [{"value": "stripe.com"}],
"current_position_seniority_level": [{"value": "VP"}]
}
)
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.
agentcash.fetch also handles SIWX-authenticated endpoints automatically when the route supports that flow.
Available Services
| Origin | Service | What it does |
|---|---|---|
https://stableenrich.dev | StableEnrich | Research APIs: FullEnrich (people/company search), PDL & Minerva (person enrichment), CompanyEnrich (company profiles), Clado (contacts), Exa (web search), Firecrawl (scraping), Cloudflare (site crawling), Google Maps + Solar + Aerial View, Serper (news/shopping/images/lens), Whitepages, Reddit, Hunter (email verification) |
https://stableupload.dev | StableUpload | File hosting ($0.005-$2.00 by size) + static site hosting with custom domains |
https://stablestudio.dev | StableStudio | AI image/video generation: GPT Image, Flux, Grok, Nano Banana, Sora, Veo, Seedance, Wan, image-to-SVG |
https://stablesocial.dev | StableSocial | Social media data: TikTok, Instagram, YouTube, Facebook, LinkedIn, Reddit, Rumble, GitHub, ad libraries (Scrape Creators), plus Lightreel UGC research agent. $0.06/call, async jobs |
https://stableemail.dev | StableEmail | Send emails ($0.02), forwarding inboxes ($1/mo), custom subdomains ($5), programmatic mailboxes |
https://stablephone.dev | StablePhone | AI phone calls ($0.54), phone numbers ($20), top-ups ($15), iMessage/FaceTime lookup ($0.05) |
https://stablejobs.dev | StableJobs | Job search via Coresignal (preview $0.10/page, collect $0.20/job) |
https://stabletravel.dev | StableTravel | Flight prices and booking (Google Flights), award availability (Seats.aero), live flight tracking and airport data (FlightAware) |
https://stablebrowser.dev | StableBrowser | Cloud browser automation: create a session ($0.10), then AI-powered navigate/act/extract/observe/screenshot (free SIWX) |
Run agentcash.discover_api_endpoints(url="<origin>") on any origin to see its full endpoint catalog.
Quick Reference
| Task | Tool |
|---|---|
| Check balance | agentcash.get_balance |
| Get deposit links and wallet addresses | agentcash.list_accounts |
| Redeem code | agentcash.redeem_invite(code="...") |
| Find APIs by natural language | agentcash.search(query="...") |
| Discover endpoints | agentcash.discover_api_endpoints(url="...") |
| Check pricing/schema | agentcash.check_endpoint_schema(url="...") |
| Paid POST request | agentcash.fetch(url="...", method="POST", body={...}) |
| Paid GET request | agentcash.fetch(url="...") |
| Authenticated GET (no payment) | agentcash.fetch(url="...") |
Tips
- Skip search when a listed origin fits the task. Go straight to
discover_api_endpoints. Only usesearchwhen no origin in the Available Services table matches. - Always discover before calling arbitrary paths — the
instructionsfield has critical endpoint-specific patterns and required parameters. - Payments settle only on success (2xx) — failed requests cost nothing.
- Use
check_endpoint_schemawhen unsure about request/response format. - Independent
agentcash.fetchcalls can run in parallel for better throughput. - Network: Base (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Currency: USDC.
Troubleshooting
| Issue | Solution |
|---|---|
| "MCP tool not found" | Reinstall MCP, restart IDE |
| "Insufficient balance" | Run agentcash.get_balance(), then agentcash.list_accounts() or redeem an invite code |
| "Payment failed" | Transient error — retry the request |
| "Invalid invite code" | Code already used or doesn't exist |
| Balance not updating | Wait for Base or Solana network confirmation (~2 sec) |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/merit-systems/agentcash-skills/agentcash-wallet">View agentcash-wallet on skillZs</a>