crewai-true402

  Stable · production-ready — semver-stable public API (v1.0).

true402 tools for CrewAI — give an agent a pre-trade rug/honeypot check for Base tokens AND search/SEO data (backlinks, keyword volume, rankings, keyword ideas), each paid for per call over x402 (USDC on Base). No accounts, no API keys — the wallet is the identity. Most of the on-chain safety checks have a free daily trial, so those tools work out of the box with no wallet configured; true402_deployer_check and the search/SEO tools are paid from the first call.

Install

pip install crewai-true402

Use

from crewai import Agent
from crewai_true402 import true402_tools

# Reads PAYER_PRIVATE_KEY from the env (a Base wallet holding a little USDC).
# Omit the key to rely on the free daily trial for most safety stalls (not true402_deployer_check).
tools = true402_tools()

trader = Agent(
    role="Base memecoin trader",
    goal="Only buy tokens that pass an on-chain safety check",
    tools=tools,
    backstory="You never ape into a token before rug-checking it.",
)

The agent gets ten tools:

Configuration

true402_tools() reads the environment, or pass a PayOpts:

from crewai_true402 import true402_tools, PayOpts

tools = true402_tools(PayOpts(
    payer_private_key="0x…",   # a Base wallet with a little USDC (gas is sponsored; USDC only)
    max_amount_usd=0.25,        # hard per-call ceiling — refuses to sign a 402 demanding more
))

Safety

The client refuses to sign anything that isn't USDC-on-Base within max_amount_usd (default $0.25, above the server's own $0.20 per-request ceiling so a legitimately-priced stall is never blocked) — so a rogue or compromised endpoint can't make your agent authorize an unexpected asset, network, or amount. The private key is used only to sign locally; it never leaves the process.

Links

• Live check in your browser: https://true402.dev/check
• API reference: https://true402.dev/docs/api · OpenAPI: https://true402.dev/openapi.json
• Also available: LangChain · MCP server · CLI

Checking tokens by hand? Send any Base token address to @True402bot on Telegram — same on-chain checks, free, no wallet.

Also available for

MCP (Claude Code / Desktop, Cursor, Hermes) · Hermes Agent · OpenClaw · ElizaOS · LangChain · CrewAI · Vercel AI SDK · Coinbase AgentKit · Virtuals GAME · CLI — same on-chain checks, one install command each: true402.dev/integrations

Paying, exactly

The rules below are the service's, not this package's — they bite whatever client you use, and they are the ones that surprise people writing their own payer.

• Pay the EXACT amount quoted in the 402. Underpaying is rejected. Overpaying is refused with 403 and never credited — settlement submits the signed value and there is no refund path, so a surplus would simply be swept. Equality is also what binds an authorization to the resource it was quoted for.
• One authorization buys exactly one response. A replay is refused, not double-charged.
• You are charged on success only. Settlement is submitted only when the endpoint returns 2xx; if it errors or times out, your signed authorization is never submitted, so there is nothing to refund.
• Some endpoints serve a few free calls per day per client IP, with no wallet. The per-operation description in the OpenAPI spec says which.

Full rules: true402.dev/terms · what is logged and kept: true402.dev/privacy

License

MIT