autogen-x402-discovery

AutoGen tool for x402 service discovery — let your AutoGen agents find and call any paid API endpoint at runtime.

When your AutoGen agent needs web search, image generation, data enrichment, or any other external capability, it calls x402_discover to find the best available service from the live x402 discovery catalog.

Installation

pip install autogen-x402-discovery

Quick Start

import autogen
from autogen_x402_discovery import register_with_autogen

config_list = [{"model": "gpt-4o", "api_key": "your-key"}]

assistant = autogen.ConversableAgent(
    "assistant",
    llm_config={"config_list": config_list},
    system_message="Use x402_discover to find paid API services when needed.",
)

# Register the discovery tool
register_with_autogen(assistant)

user_proxy = autogen.UserProxyAgent("user", human_input_mode="NEVER")
user_proxy.initiate_chat(assistant, message="Find a crypto price API under $0.01/call")

OpenAI Function Calling Schema

from autogen_x402_discovery import get_autogen_tool_schema, x402_discover

# Get the schema for use with any OpenAI-compatible API
schema = get_autogen_tool_schema()

# Call the function directly
result = x402_discover("web search", max_price_usd=0.10)
print(result)

Tool Parameters

How It Works

1. Agent calls x402_discover("web search")
2. Tool fetches the free catalog
3. Services are filtered by max_price_usd and matched by keyword
4. Results are ranked by uptime % and latency
5. Returns endpoint URL, price, and a Python snippet

Links

• x402 Discovery API
• GitHub

License

MIT