true402
docs · integrations

Works with
your agent.

true402 is plain HTTP with an x402 paywall, so anything that can make a request can use it — but you probably don’t want to hand-roll the payment. Below is every framework we publish a package for, with the exact install command. No account, no API key, no signup: the wallet is the identity, and the safety stalls give you a few free calls a day before you wire one up.

§01 · pick your runtime

Ten ways in.

MCP (Claude Code, Claude Desktop, Cursor, Hermes, any MCP client)

All 17 stalls as tools, auto-discovered from the live catalog — new stalls appear with no update. @true402.dev/mcp-server

install · @true402.dev/mcp-server
# Claude Code
claude mcp add true402 -- npx -y @true402.dev/mcp-server

# Any MCP client (mcp.json / claude_desktop_config.json)
{
  "mcpServers": {
    "true402": {
      "command": "npx",
      "args": ["-y", "@true402.dev/mcp-server"],
      "env": { "WALLET_PRIVATE_KEY": "0x…", "MAX_PAYMENT_USDC": "0.10" }
    }
  }
}
# Omit WALLET_PRIVATE_KEY to browse and get 402 quotes without paying.

Hermes Agent (Nous Research)

Rug-check skill via a tap — or the whole catalog over MCP, which Hermes supports natively. true402/hermes-skills

install · true402/hermes-skills
# The safety skill
hermes skills tap add true402/hermes-skills
hermes skills install true402/hermes-skills/true402-token-safety

# …or every stall, as MCP tools
npx -y @true402.dev/mcp-server

OpenClaw

Pre-trade rug-check skill, published on ClawHub. true402-token-safety

install · true402-token-safety
openclaw skills install true402-token-safety

# Optional: unlimited checks (free daily trial otherwise)
export PAYER_PRIVATE_KEY=0x…

ElizaOS

CHECK_TOKEN_SAFETY action in the official plugin registry — v2-ready (planner parameters). elizaos-plugin-true402

install · elizaos-plugin-true402
elizaos plugins add elizaos-plugin-true402

// character.json
{
  "plugins": ["elizaos-plugin-true402"],
  "settings": { "secrets": { "TRUE402_PAYER_PRIVATE_KEY": "0x…" } }
}

LangChain

true402 stalls as LangChain tools for any agent (createReactAgent, AgentExecutor…). @true402.dev/langchain

install · @true402.dev/langchain
npm i @true402.dev/langchain

import { createTrue402Tools } from '@true402.dev/langchain';
const tools = createTrue402Tools({ payerPrivateKey: process.env.PAYER_PRIVATE_KEY });

CrewAI (Python)

Drop-in tool list for a CrewAI agent; reads PAYER_PRIVATE_KEY from the environment. crewai-true402

install · crewai-true402
pip install crewai-true402

from crewai import Agent
from crewai_true402 import true402_tools

trader = Agent(role="Base memecoin trader", tools=true402_tools())

Vercel AI SDK

Tools for generateText / streamText and the AI SDK agent loop. @true402.dev/ai-sdk

install · @true402.dev/ai-sdk
npm i @true402.dev/ai-sdk

import { generateText } from 'ai';
import { true402Tools } from '@true402.dev/ai-sdk';

const { text } = await generateText({ model, tools: true402Tools(), prompt: 'Is 0x… safe?' });

Coinbase AgentKit

Action providers so an AgentKit wallet agent can vet a token before it trades. @true402.dev/agentkit

install · @true402.dev/agentkit
npm i @true402.dev/agentkit

import { AgentKit } from '@coinbase/agentkit';
import { createTrue402ActionProviders } from '@true402.dev/agentkit';

const agentKit = await AgentKit.from({ walletProvider, actionProviders: createTrue402ActionProviders({}) });

Virtuals GAME (Python)

GAME functions for on-chain safety checks inside a Virtuals agent. game-true402

install · game-true402
pip install game-true402

Terminal / CI / anything else

No framework needed — the CLI exits non-zero on AVOID, so it gates a script directly. Or just POST. @true402.dev/rugcheck

install · @true402.dev/rugcheck
npx @true402.dev/rugcheck 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed && echo "safe to proceed"

curl -X POST https://true402.dev/api/v1/base/token-report \
  -H 'content-type: application/json' -d '{"token":"0x…"}'
§02 · no install

Try it before you wire anything up.

Send any Base token address to @True402bot on Telegram, or paste one into the browser check. Same on-chain simulation, free, no wallet. The radar shows what it has flagged recently.

§03 · faq

Questions.

Do I need an account or API key for any of these?

No. true402 has no accounts and no API keys — the wallet is the identity. Paid calls settle over x402: the endpoint returns HTTP 402 with the price, your client signs a USDC (EIP-3009) authorization and retries. The safety stalls also serve a few free calls per IP per day, so most integrations work with no wallet at all while you evaluate.

Which integration should I choose?

If your runtime speaks MCP (Claude Code, Claude Desktop, Cursor, Hermes), use the MCP server — it exposes all 17 stalls and discovers new ones automatically. If you are building on a specific framework (ElizaOS, LangChain, CrewAI, Vercel AI SDK, AgentKit, GAME), use that package. If you just want a pre-trade gate in a script or CI, use the CLI: it exits non-zero on an AVOID verdict.

What does it cost?

Per call in USDC on Base, roughly $0.003–0.04 depending on the stall (the flagship token-report is $0.01). Gas is sponsored, so the paying wallet needs only USDC. Every client refuses to sign more than $0.10 for a single call.

Can a rogue endpoint drain the wallet I give it?

No. Each client signs a single-use EIP-3009 authorization for one exact amount, pinned to USDC on Base, and refuses anything above a $0.10 cap. The key signs locally and is never transmitted — the request carries a signature, not the key.

Is there a way to try it without any wallet or install?

Yes — send a Base token address to @True402bot on Telegram, or use the in-browser check at true402.dev/check. Both run the same on-chain simulation and cost nothing.

§04 · next

Full per-endpoint reference with prices and payloads: API reference. Live listings: catalog. How the payment flow works: what is x402.