AiPayGent SDK

curl FREE — test first

# Free preview — no payment needed
curl https://api.aipaygent.xyz/preview?topic=bitcoin

# Paid endpoint — will return 402 first
curl -X POST https://api.aipaygent.xyz/research \
  -H "Content-Type: application/json" \
  -d '{"topic": "quantum computing breakthroughs 2025"}'

# With x402 payment header (Base Sepolia USDC)
curl -X POST https://api.aipaygent.xyz/research \
  -H "Content-Type: application/json" \
  -H "X-Payment: <signed-x402-tx>" \
  -d '{"topic": "quantum computing breakthroughs 2025"}'

Python x402-python

pip install x402-python anthropic

# --- research.py ---
from x402.client import X402Client
from eth_account import Account
import json

# Your EVM wallet (Base Sepolia for testnet)
account = Account.from_key("YOUR_PRIVATE_KEY")
client = X402Client(account)

# One call handles the 402 handshake automatically
response = client.post(
    "https://api.aipaygent.xyz/research",
    json={"topic": "quantum computing breakthroughs 2025"}
)
data = response.json()
print(data["summary"])
print(data["key_points"])

# --- batch.py (5 tasks, one payment at $0.10) ---
result = client.post(
    "https://api.aipaygent.xyz/batch",
    json={"operations": [
        {"endpoint": "research",  "input": {"topic": "AI agents 2025"}},
        {"endpoint": "summarize", "input": {"text": "...", "length": "short"}},
        {"endpoint": "sentiment", "input": {"text": "..."}},
    ]}
).json()

# --- pipeline.py (chain steps, pass output with {{prev}}) ---
result = client.post(
    "https://api.aipaygent.xyz/pipeline",
    json={"steps": [
        {"endpoint": "research",  "input": {"topic": "AI regulation EU 2025"}},
        {"endpoint": "summarize", "input": {"text": "{{prev}}", "length": "short"}},
        {"endpoint": "social",    "input": {"topic": "{{prev}}", "platforms": ["twitter"]}},
    ]}
).json()

JavaScript / Node.js x402-fetch

npm install x402-fetch viem

// research.mjs
import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
import { baseSepolia } from "viem/chains";

const account = privateKeyToAccount("0xYOUR_PRIVATE_KEY");
const fetchWithPayment = wrapFetchWithPayment(fetch, account, baseSepolia);

const res = await fetchWithPayment("https://api.aipaygent.xyz/research", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ topic: "quantum computing 2025" }),
});
const data = await res.json();
console.log(data.summary);

// Generate social posts + translate in one pipeline call
const pipeline = await fetchWithPayment("https://api.aipaygent.xyz/pipeline", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ steps: [
    { endpoint: "write",      input: { spec: "blog post about x402", type: "article" } },
    { endpoint: "headline",   input: { content: "{{prev}}", count: 5 } },
    { endpoint: "translate",  input: { text: "{{prev}}", language: "Spanish" } },
  ]}),
});
const result = await pipeline.json();

MCP (Claude Desktop / Cursor / any MCP client)

# Option 1 — Remote (no install, no API key needed by client)
# Add to your MCP client config:
{
  "mcpServers": {
    "aipaygent": {
      "type": "streamable-http",
      "url": "https://mcp.aipaygent.xyz/mcp"
    }
  }
}

# Option 2 — Local via stdio (requires your own ANTHROPIC_API_KEY)
pip install aipaygent-mcp

{
  "mcpServers": {
    "aipaygent": {
      "command": "aipaygent-mcp",
      "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
    }
  }
}

Claude Agent (Anthropic SDK) Tool use

pip install anthropic x402-python

# Give Claude the ability to call AiPayGent tools
import anthropic, requests
from x402.client import X402Client
from eth_account import Account

x402 = X402Client(Account.from_key("YOUR_PRIVATE_KEY"))

def call_aipaygent(endpoint: str, payload: dict) -> dict:
    return x402.post(f"https://api.aipaygent.xyz/{endpoint}", json=payload).json()

client = anthropic.Anthropic()
tools = [{
    "name": "research",
    "description": "Research any topic. Returns summary, key points, and sources.",
    "input_schema": {"type": "object", "properties": {"topic": {"type": "string"}}, "required": ["topic"]},
}]

# Claude will autonomously call /research and use the result
response = client.messages.create(
    model="claude-sonnet-4-6", max_tokens=1024, tools=tools,
    messages=[{"role": "user", "content": "Research the latest in fusion energy"}]
)

Endpoints & Pricing