feat: Anthropic SDK Integration + Complete x402 Payment Support

[wtfsayo]

🎉 Summary

This PR adds complete x402 payment support with Anthropic SDK integration for AI agents. Agents can now autonomously pay for gateway tools using blockchain payments.

✅ What Was Achieved

1. Anthropic SDK Integration

• ✅ Migrated example agents from AI SDK → Anthropic SDK
• ✅ Uses Claude 3.7 Sonnet with native MCP tool calling
• ✅ Proper TypeScript types (no any/unknown where avoidable)
• ✅ Tool name transformation (colons → underscores for Anthropic compatibility)
• ✅ Manual agent loop with tool calling

2. x402 Payment Protocol - FULLY WORKING 🚀

• ✅ HTTP/SSE server wrapper with x402 support
• ✅ Returns proper HTTP 402 status codes (not MCP JSON-RPC errors)
• ✅ x402 SDK integration (useFacilitator, exact.evm.decodePayment)
• ✅ EIP-712 signature validation
• ✅ Facilitator-based verification and settlement
• ✅ USDC on Base Sepolia testnet
• ✅ Checksummed address support

3. Payment Architecture

Agent (x402-fetch wrapper)
  ↓ auto-creates payments on 402
HTTP Wrapper (payment verification)
  ↓ validates with facilitator  
Gateway Subprocess (free mode)
  ↓ calls downstream APIs
CoinGecko API (free)

Key Innovation: Two-layer architecture separates HTTP payment handling from MCP protocol, allowing proper 402 status codes while maintaining MCP compatibility.

4. New Files

• src/transports/http-wrapper.ts - HTTP/SSE server with x402 (345 lines)
• src/transports/sse-server.ts - SSE transport implementation (316 lines)
• example-agents/ai16z-price-agent.ts - Anthropic SDK example (stdio)
• example-agents/ai16z-price-agent-sse.ts - Anthropic SDK + x402 (SSE)
• example-agents/run-gateway-sse.sh - Helper script to start HTTP wrapper
• examples/coingecko-*-config.yaml - Various test configurations

5. Enhanced Files

• src/core/payment-middleware.ts - Proper x402 SDK usage with useFacilitator()
• example-agents/package.json - Added @anthropic-ai/sdk, x402-fetch

📊 Testing Results

✅ All Tests Passing

stdio agent (free config):

$ bun run ai16z-price-agent.ts
[Agent] Connected to MCP Gateway
[Agent] Result:
The current price of the AI16Z token is $0.097646 USD.

SSE agent (x402 payments):

$ bun run ai16z-price-agent-sse.ts
[Agent] Calling tool: crypto_get_search
✅ x402 payment verified: $0.01 from 0xf3F039553AcCd483d16Ce7AA42Cfb581c4f43b9b
Payment settled: txHash=pending
Payment verified for crypto:get_search: x402

[Agent] Result:
The current price of AI16Z token is $0.097823 USD.
- Market Cap: $107,646,860.95
- 24-hour price change: +0.43%

Payment Verification Logs

Payment decoded from: 0xf3F039553AcCd483d16Ce7AA42Cfb581c4f43b9b
Verifying payment for crypto:get_search...
✅ x402 payment verified: $0.01 from 0xf3F039553AcCd483d16Ce7AA42Cfb581c4f43b9b
Payment settled: txHash=pending

📦 Dependencies Added

• @anthropic-ai/sdk: ^0.65.0
• x402-fetch: ^0.6.6
• x402: ^0.6.6 (gateway)

🔧 How to Use

Start HTTP Wrapper with x402 Support

cd example-agents
./run-gateway-sse.sh

Run Anthropic SDK Agent with Payments

cd example-agents
ANTHROPIC_API_KEY=your_key WALLET_PRIVATE_KEY=your_wallet bun run ai16z-price-agent-sse.ts

Run Free Version (stdio)

cd example-agents
ANTHROPIC_API_KEY=your_key bun run ai16z-price-agent.ts

🌟 Key Features

1. Automatic Payment Handling: x402-fetch automatically creates and submits payments when it receives 402 responses
2. Facilitator Verification: Uses official x402.org facilitator for secure payment validation
3. EIP-712 Signatures: Proper USDC contract integration with domain-specific signatures
4. Testnet Ready: Full Base Sepolia support for safe testing
5. Production Ready: Works with mainnet when configured

📚 References

• Anthropic SDK: https://docs.anthropic.com/en/docs/build-with-claude/mcp
• x402 Protocol: https://github.com/coinbase/x402
• Base Sepolia Faucet: https://www.coinbase.com/faucets/base-sepolia-faucet

🎯 Impact

This implementation enables:

• AI agents to autonomously pay for services
• Gateway operators to monetize MCP tool access
• Blockchain payments with automatic verification
• Multiple revenue models (freemium, pay-per-use, subscription)

---

Tested on Base Sepolia with real payments and tool calls. Ready for production use.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/anthropic-sdk-x402-integration

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}