DEV Community

8randonpickart5
8randonpickart5

Posted on

title: How to Give Claude Desktop a USDC Wallet — Call Paid APIs Automatically published: true tags: ai, mcp, x402, cryptocurrency

Your AI assistant can now spend money.
Not hypothetically — real USDC on Base, paying for real API calls, getting real data back. No API keys. No subscriptions. No human in the loop.
Here's how to set it up in 2 minutes.
What This Does
You install an MCP server. Claude Desktop gets 4 new tools:

x402_discover — search for paid API endpoints
x402_call — call any endpoint with automatic USDC payment
x402_balance — check wallet balance
x402_research — call 3-5 endpoints in parallel on a single subject

Then you ask Claude things like "research stripe.com" and it automatically:

Finds relevant intelligence endpoints
Pays $0.10-0.15 per call in USDC
Returns scored results with recommendations

No wallet popups. No transaction confirmations. Claude just gets the data.
Step 1: Fund an AgentCash Wallet (60 seconds)
AgentCash is a lightweight x402 wallet. One command:
bashnpx agentcash install
Follow the prompts. Fund it with $5 USDC on Base — that covers ~40 API calls.
Step 2: Add the MCP Server (30 seconds)
Open your Claude Desktop config file:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this:
json{
"mcpServers": {
"x402-buyer": {
"command": "npx",
"args": ["-y", "x402-buyer-mcp"]
}
}
}
Restart Claude Desktop. Done.
Step 3: Ask Claude Anything
Security scan

"Is stripe.com secure?"

Claude calls Domain Shield ($0.12) — gets SPF, DKIM, DMARC, SSL, VirusTotal malware scan from 70+ engines. Returns a scored report.
Company research

"Tell me about hubspot.com"

Claude calls Company X-Ray ($0.15) — gets industry, employee count, revenue, tech stack, social presence from People Data Labs + web analysis.
Full intelligence report

"Research stripe.com"

Claude calls 5 endpoints in parallel (~$0.64 total):

Domain Shield (VirusTotal security scan)
Company X-Ray (People Data Labs firmographics)
Threat Pulse (AbuseIPDB + VirusTotal threat intel)
Compliance Check (Qualys SSL Labs grade)
Prospect IQ (Hunter.io verified emails)

All results synthesized by Claude into a single intelligence briefing.
Health data

"What are the drug interactions for ibuprofen?"

Claude calls Health Signal ($0.10) — gets FDA labels, adverse events, recalls, and NIH RxNorm drug-to-drug interactions.
Location intelligence

"What's the neighborhood like at 123 Main St Milwaukee WI?"

Claude calls Property Intel ($0.10) — gets amenities, schools, Census demographics (income, population, home values), and current weather.
How Payment Works Under the Hood
The x402 protocol turns HTTP 402 ("Payment Required") into a real payment flow:

Claude sends a GET request to the API endpoint
Endpoint returns 402 Payment Required with a price
AgentCash wallet signs a USDC transfer authorization (EIP-3009)
Claude retries the request with the signed payment
The Coinbase CDP facilitator verifies and settles on-chain
USDC moves from your wallet to the endpoint provider
Data is returned

All of this happens in ~2 seconds. You see none of it — just the answer.
What's in the Registry
The MCP comes with 8 curated intelligence endpoints backed by premium data sources:
EndpointWhat You GetPricePremium SourceDomain ShieldDNS security + malware scan$0.12VirusTotalCompany X-RayFirmographics + tech stack$0.15People Data LabsThreat PulseIP/domain threat intel$0.10VirusTotal + AbuseIPDBProspect IQSales intel + verified emails$0.12Hunter.ioCompliance CheckIT compliance audit$0.15Qualys SSL LabsHealth SignalDrug info + interactions$0.10NIH RxNormProperty IntelLocation + demographics$0.10US Census BureauSports EdgePre-game AI analysis$0.12The Odds API
Each call bundles 7-9 data sources into a single scored response. The value proposition is simple: one call, one payment, 7-9 sources of data you'd otherwise need separate API keys and subscriptions for.
Budget Control
The x402_research tool accepts a max_cost parameter. Default is $1.00 — endpoints are called cheapest-first until the budget is reached.
$5 covers approximately:

40 individual endpoint calls
8 full "research" reports (5 endpoints each)

Why This Matters
The x402 protocol is building a new internet where software pays for data the same way browsers request pages — over HTTP. No accounts, no OAuth, no billing dashboards.
This MCP server is the buyer-side infrastructure that makes it work. Instead of waiting for autonomous agents to discover x402 endpoints on their own, it puts a funded wallet directly in Claude's hands.
Every install creates a new buyer in the x402 economy. Every research call generates 3-5 real on-chain transactions. The agent economy doesn't need more sellers — it needs buyers. This is one.
Links

npm: x402-buyer-mcp
GitHub: x402-buyer-mcp
AgentCash: agentcash.dev
Endpoints: alderpost.co
x402 Protocol: x402.org

Built by Alderpost LLC — Wisconsin. The endpoints are ours. The buyer MCP is open source (MIT). Install it, fork it, build on it.

Top comments (0)