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
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.