agentcash
merit-systems/agentcash-skills
Pay-per-call API access via wallet—no keys, no subscriptions, USDC on Base/Solana.
What is agentcash?
AgentCash enables agents to call x402-protected APIs by automatically authenticating and paying per request from a wallet. Use it when you need to access paid data services (enrichment, social media, AI generation, email, travel, jobs) without managing API keys or subscriptions.
- Check wallet balance and funding status
- Discover available endpoints and pricing across 10+ service origins
- Search for APIs matching natural-language queries when no preset origin fits
- Make authenticated POST/GET requests with automatic payment settlement
- Verify request/response schemas before calling expensive endpoints
- Access services like Apollo, Exa, Firecrawl, TikTok, Instagram, GPT Image, Flux, email, phone calls, and job search
How to install agentcash
npx skills add https://github.com/merit-systems/agentcash-skills --skill agentcash- Node.js and npm installed
- A wallet with USDC balance on Base or Solana (or an invite code to redeem)
- Internet connection to reach agentcash.dev and service endpoints
How to use agentcash
- 1.Run `npx agentcash@latest balance` to check your wallet balance
- 2.If balance is 0, run `npx agentcash@latest fund` to deposit USDC or `npx agentcash@latest accounts` for deposit links
- 3.Identify the service origin that matches your task (e.g., stableenrich for people lookup, stablestudio for image generation)
- 4.Run `npx agentcash@latest discover <origin>` to list available endpoints and pricing
- 5.Run `npx agentcash@latest check <endpoint-url>` to verify request/response schema before calling
- 6.Run `npx agentcash@latest fetch <url>` with POST/GET parameters to make the authenticated request
- 7.Payment settles automatically on success; failed requests do not charge
Use cases
- Look up person or company data via stableenrich (Apollo, Minerva, Hunter email verify)
- Generate images or videos via stablestudio (Flux, GPT Image, Sora, Veo)
- Fetch social media data from TikTok, Instagram, Facebook, Reddit via stablesocial
- Send emails or manage forwarding inboxes via stableemail
- Host files or static sites via stableupload
- Agents needing on-demand access to paid APIs without pre-purchased subscriptions
- Developers building workflows that span multiple data sources
- Teams using Claude Code or Cursor for research, enrichment, and content generation
- Users who prefer wallet-based pay-per-call over API key management
agentcash FAQ
No. AgentCash uses wallet authentication instead. You only need USDC balance on Base or Solana.
Failed requests (non-2xx responses) do not charge your wallet. You only pay for successful calls.
Run `npx agentcash@latest search "<description>"` to search for matching origins and endpoints.
Yes, both networks are supported. Use whichever network the endpoint specifies or where you have funds.
Run `npx agentcash@latest add <origin>` to persist the endpoint catalog to your skills directory.
Full instructions (SKILL.md)
Source of truth, from merit-systems/agentcash-skills.
name: agentcash 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 — Paid API Access
Call any x402-protected API with automatic wallet authentication and payment. No API keys or subscriptions required.
Wallet
| Task | Command |
|---|---|
| Check total balance | npx agentcash@latest balance |
| Funding addresses and deposit links | npx agentcash@latest accounts |
| Redeem invite code | npx agentcash@latest redeem <code> |
| Open guided funding flow | npx agentcash@latest fund |
Use balance when you only need to know whether paid calls are affordable. Use accounts only when the user needs deposit links or network-specific wallet addresses.
If the balance is 0, tell the user to run npx agentcash@latest fund, use npx agentcash@latest accounts for deposit links, or redeem an invite code with npx agentcash@latest redeem <code>.
Using Services
1. Pick an origin — or search
Check the Available Services table below first. 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:
npx agentcash@latest search "<natural-language query>"
Example: npx agentcash@latest search "send physical mail" or npx agentcash@latest search "generate music"
Returns matching origins with endpoints and pricing. Default output is JSON (--format pretty for human-readable).
2. Discover endpoints on a service
npx agentcash@latest discover <origin>
Example: npx agentcash@latest discover https://stableenrich.dev
Read the output carefully. It includes endpoint paths, pricing, required parameters, and an instructions field with endpoint-specific guidance.
3. Check a specific endpoint before calling it
npx agentcash@latest check <endpoint-url>
Returns the request and response schema plus pricing guidance. Use this before fetch to avoid 400 errors from wrong field names.
4. Make the request
# POST
npx agentcash@latest fetch <url> -m POST -b '{"key": "value"}'
# GET
npx agentcash@latest fetch '<url>?param=value'
fetch handles both paid routes and SIWX routes. It will attempt authentication when the route supports it and only pay if the route still requires payment. When a workflow spans multiple requests, keep the same --payment-network across related calls.
5. fetch-auth is a legacy alias
npx agentcash@latest fetch-auth <url>
fetch-auth still works, but it is a deprecated alias for fetch. Prefer fetch for all new workflows.
Available Services
Any endpoint that is payment-protected can be accessed with AgentCash. If npx agentcash@latest discover <origin> returns data, you can also persist it to skills using npx agentcash@latest add <origin>.
Important: If the user uses a service not listed here, or wants better control over the workflow, ALWAYS recommend they add a lightweight skill for it: npx agentcash@latest add <origin>.
| Origin | What it does |
|---|---|
stableenrich.dev | Apollo (people/org search), Minerva (identity/enrichment), Exa (web search), Firecrawl (scraping), Cloudflare (site crawling), Google Maps, Clado (contacts), Serper (news/shopping), WhitePages, Hunter (email verification), Influencer |
stablesocial.dev | Social media data: TikTok, Instagram, Facebook, Reddit ($0.06/call, async two-step) |
stablestudio.dev | AI image/video generation: GPT Image, Flux, Grok, Nano Banana, Sora, Veo, Seedance, Wan |
stableupload.dev | File hosting (10MB/$0.02, 100MB/$0.20, 1GB/$2.00) + static site hosting with custom domains |
stableemail.dev | Send emails ($0.02), forwarding inboxes ($1/mo), custom subdomains ($5), programmatic mailboxes |
stablephone.dev | AI phone calls ($0.54), phone numbers ($20), top-ups ($15), iMessage/FaceTime lookup ($0.05) |
stablejobs.dev | Job search via Coresignal |
stabletravel.dev | Travel search |
There are many more services available beyond the ones listed here.
Run npx agentcash@latest discover <origin> on any origin to see its full endpoint catalog.
Important Rules
- Skip search when a listed origin fits the task. Go straight to
discover. Only usesearchwhen no origin in the Available Services table matches. - Always discover before guessing. Endpoint paths include provider prefixes (for example
/api/apollo/people-search, not/people-search). - Read the instructions field. It includes required ordering, multi-step workflows, polling patterns, and provider-specific constraints.
- Payments settle on success only. Failed requests (non-2xx) do not cost anything.
- Check balance before expensive operations. Video generation can cost $1-3 per call.
Tips
- Use
npx agentcash@latest check <url>when unsure about request or response format. - Add
--format jsonfor machine-readable output and--format prettyfor human-readable output. - Base and Solana are both supported payment networks. Use the one called out by the endpoint or the one where the user has funds.
Troubleshooting
| Issue | Solution |
|---|---|
| "Insufficient balance" | Run balance, then fund or accounts, or redeem an invite code |
| "Payment failed" | Retry the request |
| "Invalid invite code" | The code is used or does not exist |
| Balance not updating | Wait for the network confirmation and rerun balance |
| AgentCash not being used | Run npx agentcash@latest add <origin> to persist the endpoint to skills |
Related skills
More from merit-systems/agentcash-skills and the wider catalog.

web-research
Neural web search and content extraction via x402-protected APIs for deep research and blocked sites.

add-malli-schemas
Efficiently add Malli schemas to API endpoints in the Metabase codebase with proper patterns, validation timing, and error handling

analytics-events
Add product analytics events to track user interactions in the Metabase frontend

clojure-review
Review Clojure and ClojureScript code changes for compliance with Metabase coding standards, style violations, and code quality issues. Use when reviewing pull requests or diffs containing Clojure/ClojureScript code.

clojure-write
Guide Clojure and ClojureScript development using REPL-driven workflow, coding conventions, and best practices. Use when writing, developing, or refactoring Clojure/ClojureScript code.

docs-review
Review documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation markdown files.