agentcash-wallet

name	agentcash-wallet
description	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, Facebook, Reddit, LinkedIn), 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
homepage	https://agentcash.dev
metadata	{"version":2.2}

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

1. Call agentcash.list_accounts() to get per-network wallet addresses and deposit links
2. Send USDC on Base network (eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) to the matching address
3. 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	FullEnrich / CompanyEnrich / PDL people & company search, Minerva, Exa (web search), Firecrawl (scraping), Cloudflare (site crawling), Google Maps, Clado (contacts), Serper (news/shopping), WhitePages, Reddit, Hunter (email verification)
https://stableupload.dev	StableUpload	File hosting (10MB/$0.02, 100MB/$0.20, 1GB/$2.00) + static site hosting with custom domains
https://stablestudio.dev	StableStudio	AI image/video generation: GPT Image, Flux, Grok, Nano Banana, Sora, Veo, Seedance, Wan
https://stablesocial.dev	StableSocial	Social media data: TikTok, Instagram, Facebook, Reddit. $0.06/call, async two-step
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

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 use search when no origin in the Available Services table matches.
• Always discover before calling arbitrary paths — the instructions field has critical endpoint-specific patterns and required parameters.
• Payments settle only on success (2xx) — failed requests cost nothing.
• Use check_endpoint_schema when unsure about request/response format.
• Independent agentcash.fetch calls 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)