rmi-backend/sdks/python/x402_frameworks/README.md

x402 AI Framework Integrations

Pay-per-call AI tools for every major framework. No crypto knowledge required. One pip install, zero config.

Installation

pip install x402-frameworks

Usage

LangChain

from x402_frameworks import x402LangChain

x402 = x402LangChain(api_key="your-key", auto_pay=True)

@x402.wrap_tool("token_scan")
@tool
def scan_token(address: str) -> dict:
    """Scan a token for rug pull indicators."""
    return client.scan(address)

from langchain.agents import create_react_agent
agent = create_react_agent(llm, [scan_token], prompt)
# Payment handled automatically on every tool call

CrewAI

from x402_frameworks import x402CrewAI

x402 = x402CrewAI(api_key="your-key", max_budget_usd=50)

researcher = Agent(
    role="Token Researcher",
    tools=[x402.wrap("token_scan", scan_func)],
)
# Shared credit pool across all agents in the crew

AutoGen

from x402_frameworks import x402AutoGen

x402 = x402AutoGen(api_key="your-key")

analyst = AssistantAgent(
    name="TokenAnalyst",
    functions=[x402.as_function("token_scan")],
)
# AutoGen-compatible function specs with transparent payment

How It Works

1. Developer wraps a tool function with @x402.wrap_tool("tool_name")
2. When the AI agent calls the tool, x402 checks:
   • Free trial available? → use it
   • Prepaid credits? → deduct
   • Auto-pay enabled? → pay from wallet
   • None? → raise PaymentRequiredError with invoice details
3. Tool executes, result returned to agent

Supported Frameworks

Framework	Adapter	Status
LangChain	x402LangChain	✅
CrewAI	x402CrewAI	✅
AutoGen	x402AutoGen	✅
Haystack	Coming soon	⏳
Semantic Kernel	Coming soon	⏳

Configuration

Env Var	Default	Description
X402_API_KEY	""	API key for authenticated access
X402_BASE_URL	https://mcp.rugmunch.io/mcp/x402	x402 MCP endpoint
X402_AUTO_PAY	false	Auto-pay invoices from wallet
X402_MAX_BUDGET	0	Monthly budget cap (0 = unlimited)