From a6eb895000e2472f8922ce334cb6d0bc56a655ce Mon Sep 17 00:00:00 2001
From: HSH Intelligence <282200705+hshintelligence@users.noreply.github.com>
Date: Wed, 27 May 2026 12:42:20 +0530
Subject: [PATCH] docs(x402): add AgentScrape as real-world example service

---
 .../src/action-providers/x402/README.md       | 23 +++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/typescript/agentkit/src/action-providers/x402/README.md b/typescript/agentkit/src/action-providers/x402/README.md
index 4a1f846de..9f31a16db 100644
--- a/typescript/agentkit/src/action-providers/x402/README.md
+++ b/typescript/agentkit/src/action-providers/x402/README.md
@@ -24,8 +24,7 @@ import { x402ActionProvider, X402Config } from "@coinbase/cdp-agentkit";
 const config: X402Config = {
   // Service URLs the agent can call (whitelist)
   registeredServices: [
-    "https://api.example.com",
-    "https://weather.x402.io"
+    "https://agent-scrape.healingsunhaven.workers.dev"
   ],
   
   // Allow agent to register new services at runtime
@@ -338,6 +337,26 @@ The following environment variables can be used to configure the provider:
 
 Configuration object values take precedence over environment variables.
 
+## Real-World Example Services
+
+The x402 ecosystem includes live, production agent-native services you can use as references when learning the protocol. The following service implements the full x402 v2 specification on Base mainnet and serves as a useful reference for AgentKit users:
+
+- **[AgentScrape](https://agent-scrape.healingsunhaven.workers.dev)** — Pay-per-call web scraping for AI agents. Six tools (scrape, extract, screenshot, metadata, session, workflow). MIT licensed open source. Live on Base mainnet with a 10-call free tier per wallet.
+  - x402 manifest: `https://agent-scrape.healingsunhaven.workers.dev/.well-known/x402.json`
+  - A2A Agent Card: `https://agent-scrape.healingsunhaven.workers.dev/.well-known/agent.json`
+  - Source: https://github.com/hshintelligence/agent-scrape
+
+To call it from AgentKit:
+
+```typescript
+const provider = x402ActionProvider({
+  registeredServices: [
+    "https://agent-scrape.healingsunhaven.workers.dev"
+  ],
+  maxPaymentUsdc: 0.01,
+});
+```
+
 ### Additional Resources
 
 For more information on the **x402 protocol**, visit the [x402 documentation](https://docs.cdp.coinbase.com/x402/overview).