Use draconic21 as a CrewAI tool

Prerequisites

• A wallet on the Base network (chain id 8453) funded with a little USDC — a few dollars covers hundreds of calls at these prices.
• An x402 v2 client library (installed per snippet below) that can sign the "exact" EVM payment scheme (EIP-3009, gasless — no ETH for gas needed on your side).
• Your wallet's private key available to your own process/agent — never share it, never commit it, never paste it into a chat with an AI you don't fully trust with funds.

Install

pip install crewai "x402[evm,requests]"

The code

"""CrewAI tool for a draconic21 x402 paid route.

CrewAI has no merged official x402 integration (crewAIInc/crewAI PR #5785,
a CoinbaseAgenticWalletTool with x402 support, was closed unmerged). This
subclasses crewai.tools.BaseTool and reuses the official `x402` PyPI
package's `requests` session wrapper for the actual payment.

Install:
    pip install crewai "x402[evm,requests]"

Run it standalone (no crew/agent; dry run with no key -- prints the 402
challenge and stops):
    python tool.py
"""

import json
import os
from typing import Optional, Type

import requests
from crewai.tools import BaseTool
from pydantic import BaseModel, Field

ORIGIN = os.environ.get("DRACONIC21_ORIGIN", "https://draconic21-x402-api.onrender.com")


def _build_session():
    """Return a payment-aware requests.Session, or None if no wallet is set."""
    private_key = os.environ.get("BUYER_PRIVATE_KEY")
    if not private_key:
        return None
    from eth_account import Account
    from x402 import x402ClientSync
    from x402.http.clients import x402_requests
    from x402.mechanisms.evm.signers import EthAccountSigner
    from x402.mechanisms.evm.exact.register import register_exact_evm_client

    client = x402ClientSync()
    register_exact_evm_client(client, EthAccountSigner(Account.from_key(private_key)))
    return x402_requests(client)


class TreasuryFiscalSnapshotInput(BaseModel):
    """No fields required -- the route takes an empty body."""


class TreasuryFiscalSnapshotTool(BaseTool):
    name: str = "treasury_fiscal_snapshot"
    description: str = (
        "Get total U.S. public debt outstanding, recent Treasury operating cash "
        "balance, and current Treasury FX rates in one call. Paid x402 call: "
        "$0.005 USDC on Base per call."
    )
    args_schema: Type[BaseModel] = TreasuryFiscalSnapshotInput

    def _run(self) -> str:
        session = _build_session()
        if session is None:
            return (
                "No BUYER_PRIVATE_KEY configured -- this tool needs a Base wallet "
                "funded with USDC to pay the $0.005 x402 charge per call."
            )
        resp = session.post(f"{ORIGIN}/v1/treasury_fiscal_snapshot", json={}, timeout=15)
        resp.raise_for_status()
        return json.dumps(resp.json())


def _dry_run() -> None:
    resp = requests.post(f"{ORIGIN}/v1/treasury_fiscal_snapshot", json={}, timeout=15)
    print(
        "Unpaid call status:",
        resp.status_code,
        "(402 = tool would need BUYER_PRIVATE_KEY to proceed)",
    )


if __name__ == "__main__":
    _dry_run()

Add TreasuryFiscalSnapshotTool() to any Crew's tools list. Dry-run (no key) prints the payment challenge and pays nothing; set BUYER_PRIVATE_KEY to actually pay $0.005 per call.

Routes you can call this way

Every example below targets one specific route to keep the snippet runnable, but the same client works against any draconic21 x402 route. Full list and schemas: /openapi.json.

More