PluginBench
Skill
Review
Audit score 70

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
Prerequisites
  • 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
Claude Code
Cursor
Windsurf
Cline

How to use agentcash

  1. 1.Run `npx agentcash@latest balance` to check your wallet balance
  2. 2.If balance is 0, run `npx agentcash@latest fund` to deposit USDC or `npx agentcash@latest accounts` for deposit links
  3. 3.Identify the service origin that matches your task (e.g., stableenrich for people lookup, stablestudio for image generation)
  4. 4.Run `npx agentcash@latest discover <origin>` to list available endpoints and pricing
  5. 5.Run `npx agentcash@latest check <endpoint-url>` to verify request/response schema before calling
  6. 6.Run `npx agentcash@latest fetch <url>` with POST/GET parameters to make the authenticated request
  7. 7.Payment settles automatically on success; failed requests do not charge

Use cases

Good for
  • 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
Who it's for
  • 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

Do I need API keys?

No. AgentCash uses wallet authentication instead. You only need USDC balance on Base or Solana.

What happens if a request fails?

Failed requests (non-2xx responses) do not charge your wallet. You only pay for successful calls.

How do I find an API that is not in the Available Services table?

Run `npx agentcash@latest search "<description>"` to search for matching origins and endpoints.

Can I use both Base and Solana?

Yes, both networks are supported. Use whichever network the endpoint specifies or where you have funds.

How do I add a service to my skills permanently?

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

TaskCommand
Check total balancenpx agentcash@latest balance
Funding addresses and deposit linksnpx agentcash@latest accounts
Redeem invite codenpx agentcash@latest redeem <code>
Open guided funding flownpx 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:

TaskOrigin (skip search)
Look up a person or companystableenrich.dev
Generate an image or videostablestudio.dev
Get Instagram/TikTok datastablesocial.dev
Send an emailstableemail.dev
Upload a filestableupload.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>.

OriginWhat it does
stableenrich.devApollo (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.devSocial media data: TikTok, Instagram, Facebook, Reddit ($0.06/call, async two-step)
stablestudio.devAI image/video generation: GPT Image, Flux, Grok, Nano Banana, Sora, Veo, Seedance, Wan
stableupload.devFile hosting (10MB/$0.02, 100MB/$0.20, 1GB/$2.00) + static site hosting with custom domains
stableemail.devSend emails ($0.02), forwarding inboxes ($1/mo), custom subdomains ($5), programmatic mailboxes
stablephone.devAI phone calls ($0.54), phone numbers ($20), top-ups ($15), iMessage/FaceTime lookup ($0.05)
stablejobs.devJob search via Coresignal
stabletravel.devTravel 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 use search when 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 json for machine-readable output and --format pretty for 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

IssueSolution
"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 updatingWait for the network confirmation and rerun balance
AgentCash not being usedRun npx agentcash@latest add <origin> to persist the endpoint to skills