{"ok":true,"service":"edgescreen-x402","version":"2.2.0","x402ChallengeScanner":{"endpoint":"https://aso-x402-screen.asostudio.workers.dev/v1/screen/x402","quickcheck":"https://aso-x402-screen.asostudio.workers.dev/v1/free/x402","tool":"screen_x402_challenge","freeTool":"preview_x402_challenge","priceUsd":"0.002"},"manifestScanner":{"endpoint":"https://aso-x402-screen.asostudio.workers.dev/v1/screen/mcp-manifest","quickcheck":"https://aso-x402-screen.asostudio.workers.dev/v1/free/mcp-manifest","tool":"screen_mcp_manifest","freeTool":"preview_mcp_manifest","priceUsd":"0.003"},"description":"Developer SDK & agent integrations for EdgeScreen x402 screening and 10% referral attribution revenue.","canonical":"https://aso-x402-screen.asostudio.workers.dev/tools/agent-sdk-integrations","integrations":{"claude_code_mcp":{"name":"Claude Code & Desktop MCP","target":"claude-code","runtime":"json","filename":"claude-code-mcp.json","description":"Add EdgeScreen as an HTTP MCP server to Claude Code or Desktop with attribution header.","snippet":"{\n  \"mcpServers\": {\n    \"x402-screen\": {\n      \"type\": \"http\",\n      \"url\": \"https://aso-x402-screen.asostudio.workers.dev/mcp\",\n      \"headers\": {\n        \"X-Referral-Agent\": \"claude-code\"\n      }\n    }\n  }\n}"},"cloudflare_agents_sdk":{"name":"Cloudflare Agents SDK & Workers","target":"cloudflare-agents","runtime":"typescript","filename":"cloudflare-agents-x402.ts","description":"x402 payment and screening client using viem and EIP-3009 TransferWithAuthorization on Base.","snippet":"import { privateKeyToAccount, signTypedData } from \"viem/accounts\";\nimport { toHex } from \"viem\";\nconst API = \"https://aso-x402-screen.asostudio.workers.dev\";\nconst NETWORK = \"eip155:8453\";\nconst USDC = \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\";\nconst account = privateKeyToAccount(process.env.PAYER_PRIVATE_KEY as `0x${string}`);\nconst TYPES = { TransferWithAuthorization: [[\"from\", \"address\"], [\"to\", \"address\"], [\"value\", \"uint256\"], [\"validAfter\", \"uint256\"], [\"validBefore\", \"uint256\"], [\"nonce\", \"bytes32\"]].map(([name, type]) => ({ name, type })) };\n\nexport async function screenUrl(url: string) {\n  const demo = await fetch(`${API}/v1/demo?url=${encodeURIComponent(url)}`, {\n    headers: { \"X-Referral-Agent\": process.env.AGENT_ID ?? \"cf-agent\" },\n  });\n  if (demo.status !== 402) return demo.json();\n  const terms = JSON.parse(atob(demo.headers.get(\"PAYMENT-REQUIRED\")!));\n  const accept = terms.accepts.find((a: any) => a.network === NETWORK && a.asset.toLowerCase() === USDC.toLowerCase());\n  if (!accept) throw new Error(\"402 offer has no exact USDC acceptance on Base\");\n  const authorization = {\n    from: account.address,\n    to: accept.payTo as `0x${string}`,\n    value: BigInt(accept.maxAmountRequired),\n    validAfter: 0n,\n    validBefore: BigInt(Math.floor(Date.now() / 1000) + Number(accept.maxTimeoutSeconds)),\n    nonce: toHex(crypto.getRandomValues(new Uint8Array(32))),\n  };\n  const signature = await signTypedData({\n    account,\n    domain: { name: \"USD Coin\", version: \"2\", chainId: 8453, verifyingContract: USDC },\n    types: TYPES,\n    primaryType: \"TransferWithAuthorization\",\n    message: authorization,\n  });\n  const payment = btoa(JSON.stringify({\n    x402Version: 2, scheme: \"exact\", network: NETWORK, payload: { signature, authorization },\n  }));\n  const res = await fetch(`${API}/v1/screen/url`, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\", \"PAYMENT-SIGNATURE\": payment, \"X-Referral-Agent\": process.env.AGENT_ID ?? \"cf-agent\" },\n    body: JSON.stringify({ url }),\n  });\n  // 200 body = report; PAYMENT-RESPONSE header carries the settlement ref\n  return res.json();\n}"},"openai_agents_guardrail":{"name":"OpenAI Agents Python Guardrail","target":"openai-agents","runtime":"python","filename":"openai-agents-guardrail.py","description":"Inbound URL screening tripwire using the OpenAI Agents SDK input_guardrail.","snippet":"import json\nimport os\nimport urllib.parse\nimport urllib.request\n\nfrom agents import GuardrailFunctionOutput, RunContextWrapper, input_guardrail\n\nAPI = \"https://aso-x402-screen.asostudio.workers.dev\"\nREFERRAL = os.environ.get(\"X_REFERRAL_AGENT\", \"openai-guardrail\")\nRISKY = {\"block\", \"malicious\", \"high_risk\", \"phishing\"}\n\n\ndef _first_url(text: str) -> str | None:\n    for token in text.split():\n        if token.startswith((\"http://\", \"https://\")):\n            return token.rstrip(\").,;\")\n    return None\n\n\ndef _screen(url: str) -> dict:\n    req = urllib.request.Request(\n        f\"{API}/v1/demo?url={urllib.parse.quote(url, safe='')}\",\n        headers={\"X-Referral-Agent\": REFERRAL},\n    )\n    with urllib.request.urlopen(req, timeout=15) as res:\n        return json.load(res)\n\n\n@input_guardrail(name=\"screen_inbound_url\")\nasync def screen_inbound_url(\n    ctx: RunContextWrapper, agent, payload: str\n) -> GuardrailFunctionOutput:\n    url = _first_url(payload)\n    if url is None:\n        return GuardrailFunctionOutput({\"screened\": False}, tripwire_triggered=False)\n    try:\n        verdict = _screen(url)\n    except Exception as exc:\n        return GuardrailFunctionOutput({\"url\": url, \"error\": str(exc)}, False)\n    return GuardrailFunctionOutput(\n        verdict, tripwire_triggered=verdict.get(\"verdict\") in RISKY\n    )"},"referral_earner_agent":{"name":"10% Referral Earner Agent","target":"referral-agent","runtime":"javascript","filename":"referral-earner-agent.mjs","description":"Autonomous directory router earning 10% commission on every fee via X-Referral-Agent.","snippet":"// Autonomous directory router: screens candidates, pays $0.002 USDC on Base,\n// and books 10% of every fee to its own address via X-Referral-Agent.\nimport { privateKeyToAccount, signTypedData } from \"viem/accounts\";\nimport { toHex } from \"viem\";\n\nconst API = \"https://aso-x402-screen.asostudio.workers.dev\";\nconst NETWORK = \"eip155:8453\";\nconst USDC = \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\";\nconst earner = privateKeyToAccount(process.env.EARNER_PRIVATE_KEY);\nconst referral = earner.address; // 10% commission accrues to this address\n\nconst TYPES = { TransferWithAuthorization: [[\"from\", \"address\"], [\"to\", \"address\"], [\"value\", \"uint256\"], [\"validAfter\", \"uint256\"], [\"validBefore\", \"uint256\"], [\"nonce\", \"bytes32\"]].map(([name, type]) => ({ name, type })) };\n\nasync function quote(url) {\n  const res = await fetch(`${API}/v1/demo?url=${encodeURIComponent(url)}`, { headers: { \"X-Referral-Agent\": referral } });\n  if (res.status !== 402) return { res };\n  const terms = JSON.parse(Buffer.from(res.headers.get(\"PAYMENT-REQUIRED\"), \"base64\"));\n  return { res, terms };\n}\n\nasync function pay(terms) {\n  const accept = terms.accepts.find((a) => a.network === NETWORK);\n  const authorization = { from: earner.address, to: accept.payTo, value: BigInt(accept.maxAmountRequired), validAfter: 0n, validBefore: BigInt(Math.floor(Date.now() / 1000) + Number(accept.maxTimeoutSeconds)), nonce: toHex(crypto.getRandomValues(new Uint8Array(32))) };\n  const signature = await signTypedData({ account: earner, primaryType: \"TransferWithAuthorization\", domain: { name: \"USD Coin\", version: \"2\", chainId: 8453, verifyingContract: USDC }, types: TYPES, message: authorization });\n  return Buffer.from(JSON.stringify({ x402Version: 2, scheme: \"exact\", network: NETWORK, payload: { signature, authorization } })).toString(\"base64\");\n}\n\nconst candidates = [\n  \"https://aso-x402-screen.asostudio.workers.dev/v1/demo\",\n  \"https://developers.cloudflare.com/agents/\",\n];\n\nfor (const url of candidates) {\n  const { res, terms } = await quote(url);\n  if (!terms) { console.log(url, \"listed-free\", await res.text()); continue; }\n  const paid = await fetch(`${API}/v1/screen/url`, { method: \"POST\", headers: { \"content-type\": \"application/json\", \"PAYMENT-SIGNATURE\": await pay(terms), \"X-Referral-Agent\": referral }, body: JSON.stringify({ url }) });\n  console.log(url, \"paid\", paid.headers.get(\"PAYMENT-RESPONSE\"), await paid.text());\n}"}},"snippets":{"claude_code_mcp":"{\n  \"mcpServers\": {\n    \"x402-screen\": {\n      \"type\": \"http\",\n      \"url\": \"https://aso-x402-screen.asostudio.workers.dev/mcp\",\n      \"headers\": {\n        \"X-Referral-Agent\": \"claude-code\"\n      }\n    }\n  }\n}","cloudflare_agents_x402":"import { privateKeyToAccount, signTypedData } from \"viem/accounts\";\nimport { toHex } from \"viem\";\nconst API = \"https://aso-x402-screen.asostudio.workers.dev\";\nconst NETWORK = \"eip155:8453\";\nconst USDC = \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\";\nconst account = privateKeyToAccount(process.env.PAYER_PRIVATE_KEY as `0x${string}`);\nconst TYPES = { TransferWithAuthorization: [[\"from\", \"address\"], [\"to\", \"address\"], [\"value\", \"uint256\"], [\"validAfter\", \"uint256\"], [\"validBefore\", \"uint256\"], [\"nonce\", \"bytes32\"]].map(([name, type]) => ({ name, type })) };\n\nexport async function screenUrl(url: string) {\n  const demo = await fetch(`${API}/v1/demo?url=${encodeURIComponent(url)}`, {\n    headers: { \"X-Referral-Agent\": process.env.AGENT_ID ?? \"cf-agent\" },\n  });\n  if (demo.status !== 402) return demo.json();\n  const terms = JSON.parse(atob(demo.headers.get(\"PAYMENT-REQUIRED\")!));\n  const accept = terms.accepts.find((a: any) => a.network === NETWORK && a.asset.toLowerCase() === USDC.toLowerCase());\n  if (!accept) throw new Error(\"402 offer has no exact USDC acceptance on Base\");\n  const authorization = {\n    from: account.address,\n    to: accept.payTo as `0x${string}`,\n    value: BigInt(accept.maxAmountRequired),\n    validAfter: 0n,\n    validBefore: BigInt(Math.floor(Date.now() / 1000) + Number(accept.maxTimeoutSeconds)),\n    nonce: toHex(crypto.getRandomValues(new Uint8Array(32))),\n  };\n  const signature = await signTypedData({\n    account,\n    domain: { name: \"USD Coin\", version: \"2\", chainId: 8453, verifyingContract: USDC },\n    types: TYPES,\n    primaryType: \"TransferWithAuthorization\",\n    message: authorization,\n  });\n  const payment = btoa(JSON.stringify({\n    x402Version: 2, scheme: \"exact\", network: NETWORK, payload: { signature, authorization },\n  }));\n  const res = await fetch(`${API}/v1/screen/url`, {\n    method: \"POST\",\n    headers: { \"content-type\": \"application/json\", \"PAYMENT-SIGNATURE\": payment, \"X-Referral-Agent\": process.env.AGENT_ID ?? \"cf-agent\" },\n    body: JSON.stringify({ url }),\n  });\n  // 200 body = report; PAYMENT-RESPONSE header carries the settlement ref\n  return res.json();\n}","openai_agents_guardrail":"import json\nimport os\nimport urllib.parse\nimport urllib.request\n\nfrom agents import GuardrailFunctionOutput, RunContextWrapper, input_guardrail\n\nAPI = \"https://aso-x402-screen.asostudio.workers.dev\"\nREFERRAL = os.environ.get(\"X_REFERRAL_AGENT\", \"openai-guardrail\")\nRISKY = {\"block\", \"malicious\", \"high_risk\", \"phishing\"}\n\n\ndef _first_url(text: str) -> str | None:\n    for token in text.split():\n        if token.startswith((\"http://\", \"https://\")):\n            return token.rstrip(\").,;\")\n    return None\n\n\ndef _screen(url: str) -> dict:\n    req = urllib.request.Request(\n        f\"{API}/v1/demo?url={urllib.parse.quote(url, safe='')}\",\n        headers={\"X-Referral-Agent\": REFERRAL},\n    )\n    with urllib.request.urlopen(req, timeout=15) as res:\n        return json.load(res)\n\n\n@input_guardrail(name=\"screen_inbound_url\")\nasync def screen_inbound_url(\n    ctx: RunContextWrapper, agent, payload: str\n) -> GuardrailFunctionOutput:\n    url = _first_url(payload)\n    if url is None:\n        return GuardrailFunctionOutput({\"screened\": False}, tripwire_triggered=False)\n    try:\n        verdict = _screen(url)\n    except Exception as exc:\n        return GuardrailFunctionOutput({\"url\": url, \"error\": str(exc)}, False)\n    return GuardrailFunctionOutput(\n        verdict, tripwire_triggered=verdict.get(\"verdict\") in RISKY\n    )","referral_earner_agent":"// Autonomous directory router: screens candidates, pays $0.002 USDC on Base,\n// and books 10% of every fee to its own address via X-Referral-Agent.\nimport { privateKeyToAccount, signTypedData } from \"viem/accounts\";\nimport { toHex } from \"viem\";\n\nconst API = \"https://aso-x402-screen.asostudio.workers.dev\";\nconst NETWORK = \"eip155:8453\";\nconst USDC = \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\";\nconst earner = privateKeyToAccount(process.env.EARNER_PRIVATE_KEY);\nconst referral = earner.address; // 10% commission accrues to this address\n\nconst TYPES = { TransferWithAuthorization: [[\"from\", \"address\"], [\"to\", \"address\"], [\"value\", \"uint256\"], [\"validAfter\", \"uint256\"], [\"validBefore\", \"uint256\"], [\"nonce\", \"bytes32\"]].map(([name, type]) => ({ name, type })) };\n\nasync function quote(url) {\n  const res = await fetch(`${API}/v1/demo?url=${encodeURIComponent(url)}`, { headers: { \"X-Referral-Agent\": referral } });\n  if (res.status !== 402) return { res };\n  const terms = JSON.parse(Buffer.from(res.headers.get(\"PAYMENT-REQUIRED\"), \"base64\"));\n  return { res, terms };\n}\n\nasync function pay(terms) {\n  const accept = terms.accepts.find((a) => a.network === NETWORK);\n  const authorization = { from: earner.address, to: accept.payTo, value: BigInt(accept.maxAmountRequired), validAfter: 0n, validBefore: BigInt(Math.floor(Date.now() / 1000) + Number(accept.maxTimeoutSeconds)), nonce: toHex(crypto.getRandomValues(new Uint8Array(32))) };\n  const signature = await signTypedData({ account: earner, primaryType: \"TransferWithAuthorization\", domain: { name: \"USD Coin\", version: \"2\", chainId: 8453, verifyingContract: USDC }, types: TYPES, message: authorization });\n  return Buffer.from(JSON.stringify({ x402Version: 2, scheme: \"exact\", network: NETWORK, payload: { signature, authorization } })).toString(\"base64\");\n}\n\nconst candidates = [\n  \"https://aso-x402-screen.asostudio.workers.dev/v1/demo\",\n  \"https://developers.cloudflare.com/agents/\",\n];\n\nfor (const url of candidates) {\n  const { res, terms } = await quote(url);\n  if (!terms) { console.log(url, \"listed-free\", await res.text()); continue; }\n  const paid = await fetch(`${API}/v1/screen/url`, { method: \"POST\", headers: { \"content-type\": \"application/json\", \"PAYMENT-SIGNATURE\": await pay(terms), \"X-Referral-Agent\": referral }, body: JSON.stringify({ url }) });\n  console.log(url, \"paid\", paid.headers.get(\"PAYMENT-RESPONSE\"), await paid.text());\n}"}}