Enables AI agents to access pay-per-call AI inference, web extraction, and on-chain token safety tools using USDC micropayments on Base.
Also known as true402/mcp-server, @true402.dev/mcp-server
- Stars
- 0
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- 1.3.2
- Last commit
- Nov 13, 2026
- License
- MIT
What is true402 MCP?
true402 enables AI agents to access pay-per-call AI inference, web extraction, and on-chain token safety tools using USDC micropayments on Base. It exposes 13 tools, such as list_models, chat, seo_audit.
Summary generated from the project's README
About true402 MCP server
Providing AI agents with pay-per-call access to specialized web and blockchain tools is what this server enables through the true402 marketplace. Developers can connect this server to clients like Claude Desktop, Cursor, or Cline using npx to grant their agents access to a live catalog of services. Instead of managing traditional API keys or accounts, the agent uses a funded Base wallet as its identity to settle micropayments in USDC via the x402 protocol.
The server automatically discovers available tools at startup, ranging from token safety checks and liquidity history on Base, Ethereum, and BSC to web extraction and SEO audits. Users configure a private key in their environment variables to allow for automated payments, setting a MAX_PAYMENT_USDC ceiling to control spending. Because gas is sponsored by the facilitator, the connected wallet only needs USDC to function. This setup allows agents to perform complex tasks like running a tx_preflight on an unsigned transaction or generating a full token_dossier without manual intervention.
What you can do with it
- 1Perform pre-trade transaction auditsHave the agent check an unsigned Base transaction for potential risks like liquidity draining or unlimited approvals.
- 2Extract and analyze web contentInstruct the agent to take a screenshot of a website or extract text from a specific URL.
- 3Conduct SEO and keyword researchRequest a detailed SEO audit for a webpage or a list of high-volume keyword ideas.
Written from the project's README. Every use case is checked against a quote from it.
How to install true402 MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall true402 MCP in Claude Code
$ claude mcp add --env 'WALLET_PRIVATE_KEY=<YOUR_WALLET_PRIVATE_KEY>' mcp-server -- npx -y @true402.dev/mcp-serverInstall true402 MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@true402.dev/mcp-server"
],
"env": {
"WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
}
}
}
}Install true402 MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@true402.dev/mcp-server"
],
"env": {
"WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
}
}
}
}Install true402 MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@true402.dev/mcp-server"],"env":{"WALLET_PRIVATE_KEY":"<YOUR_WALLET_PRIVATE_KEY>"}}'Install true402 MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@true402.dev/mcp-server"
],
"env": {
"WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
}
}
}
}Install true402 MCP in Codex
$ codex mcp add mcp-server --env 'WALLET_PRIVATE_KEY=<YOUR_WALLET_PRIVATE_KEY>' -- npx -y @true402.dev/mcp-serverInstall true402 MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@true402.dev/mcp-server"] [mcp_servers.mcp-server.env] WALLET_PRIVATE_KEY = "<YOUR_WALLET_PRIVATE_KEY>"
Install true402 MCP in Gemini CLI
$ gemini mcp add -s user -e 'WALLET_PRIVATE_KEY=<YOUR_WALLET_PRIVATE_KEY>' mcp-server npx -- -y @true402.dev/mcp-serverInstall true402 MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@true402.dev/mcp-server"
],
"env": {
"WALLET_PRIVATE_KEY": "<YOUR_WALLET_PRIVATE_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @true402.dev/mcp-server 1.3.2 in an isolated container with no network and no keys. It answered and listed 13 tools.
true402 MCP tools 13
Read from the server with tools/listlist_modelsList every LLM model available through true402's pay-per-call inference, with live per-token pricing (3% over provider cost, min $0.0001/request). Returns each model's id, provider, and input/output token prices across OpenAI, Anthropic, Google, Groq, Mistral and Together — so an agent can pick a model and know the exact cost before paying via x402 (USDC on Base, no account or API key).
chatSend a chat completion request to an LLM via true402 (PAID x402 service, USDC on Base). Requires a funded wallet (WALLET_PRIVATE_KEY) on the MCP server.
seo_auditAudit a web page for SEO + GEO (generative-engine-optimization). Returns a structured JSON report: meta tags, an SEO score with per-category breakdown + issues, a GEO score with breakdown + issues, and a combined percentage. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
web_extractFetch a URL and return its clean readable text, a light markdown rendering, all links (in document order), and metadata (title, description, word count, byte size). PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
link_previewFetch a URL and return its link-preview / Open Graph unfurl card: title, description, image, siteName, type, canonical URL, favicon, and theme color (image/canonical/favicon resolved to absolute URLs). PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
robots_checkReport a site's AI-crawler policy (GPTBot, ClaudeBot, Google-Extended, PerplexityBot, and ~15 other AI bots: allow | block | unspecified), plus declared sitemaps and whether an llms.txt is present. Pass any URL on the target site. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
headers_checkAnalyse a URL's HTTP security headers (HSTS, CSP, X-Frame-Options, and more) into a present/missing breakdown plus a 0-100 score, along with status, HTTPS flag, and server banner. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
token_safetyRug/honeypot safety check for an ERC-20 token on Base (on-chain reads, no API key): ERC-20 conformance, ownership renounce, mint capability, WETH/USDC liquidity depth (Uniswap V3 + Aerodrome), and a buy/sell honeypot simulation (a gas-free eth_call that round-trips a tiny WETH→token→WETH trade to catch tokens you can buy but not sell). Returns a 0-100 score + risk band + flags. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
new_pairsRecently-created Base DEX pairs (Uniswap V3 + Aerodrome) — fresh token launches for trading/sniper agents. Returns each new token, its quote (WETH/USDC), pool, fee|stable, block and approx age, newest first. Bundle with token_safety for a pre-trade rug/honeypot check. On-chain log indexing, no API key. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
liquidity_pullsLiquidity-pull / rug alerts on Base — liquidity-removal (Burn) events on recently-launched DEX pools (Uniswap V3 + Aerodrome). Returns the pool, token, and WETH/USDC amount removed (the rug magnitude), newest first — an early rug warning. Cross-check the token with token_safety. On-chain log indexing, no API key. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
whale_swapsRecent large ($-value) Base DEX Swap events (whale trades) on tracked pools — a whale-following / copy-trade signal. Returns the pool, dex, token, quote (WETH/USDC), USD size, direction (buy/sell of the non-quote token), block and approx age, newest first. On-chain log indexing, no API key. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
liquidity_historyObserved liquidity history for one Base token, from true402's own DEX archive. Returns every pool indexed for it, every liquidity-removal event with the amount removed, block and transaction hash, and the OTHER tokens drained in the same transaction (one actor, several pools). Unlike a live honeypot simulation this answers what already happened — a pool drained last month simulates fine today if it was re-seeded. Every answer carries the exact block range the removal index covers, so 'none observed' is never a claim of safety. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
Show all 13 toolsShow fewer tools
tx_preflightCheck a Base transaction BEFORE signing it. Send an UNSIGNED transaction and get three independent lenses: a simulation against current state (does it revert?), the decoded intent (is this an unlimited approval that outlives the trade?), and the counterparty's liquidity-removal history from true402's archive. Takes NO private key and NO signature, so the service cannot broadcast or front-run the transaction it inspects. Never returns 'safe': a clean result means these checks found nothing, and every response states its limits. PAID x402 service (USDC on Base) — needs a funded wallet on the MCP server.
Configuration
WALLET_PRIVATE_KEYSecretFunded Base wallet private key for x402 payment signing (optional; without it, paid tools return the 402 requirements).
MAX_PAYMENT_USDCClient-side per-call spend ceiling in USDC (default 0.10). The signer refuses to auto-pay a 402 whose amount exceeds this — protects the wallet from a hostile endpoint.
SERVER_URLtrue402 API base (default https://true402.dev/api). Must be https (or localhost) — the signer refuses to send a payment over cleartext.
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletrue402/mcp-server is public and reachablegithub.com/true402/mcp-server ↗Pass
- Package names this repository as its source@true402.dev/mcp-server names true402/mcp-server as sourcenpmjs.com/package/@true402.dev/mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/true402/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @true402.dev/mcp-serverPass
- No critical advisory in the package or its dependencies112 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@true402.dev/mcp-server
MCP server for the true402 machine-native marketplace — give your agent pay-per-call access to AI inference and web tools over x402 (HTTP 402 micropayments in USDC on Base).
No accounts, no API keys. The agent's wallet is its identity: each paid tool returns an HTTP 402 challenge, the server signs an EIP-3009 USDC authorization, and the call settles on-chain. Configure a funded wallet to auto-pay, or run without one and the paid tools will surface the exact payment requirements instead of failing.
Tools
Tools are auto-discovered from the live catalog at startup, so a new marketplace stall appears without an update to this package. The catalog currently yields:
| Group | Tools | Price |
|---|---|---|
| Token safety (Base) | token_report (composite avoid/caution/ok verdict — the pre-trade gate), token_safety, honeypot, address_safety, address_risk, deployer_check |
$0.005–0.008 |
| Base history & flow | liquidity_history (every observed liquidity removal + co-drained tokens), liquidity_pulls, new_pairs, whale_swaps |
$0.003–0.005 |
| Before you sign | tx_preflight — an unsigned Base transaction: does it revert, does it grant an unlimited approval, has the counterparty drained liquidity. Takes no key and no signature |
$0.008 |
| Full dossier | token_dossier — verdict + reasons over deployer and liquidity history, and what could not be established |
$0.10 |
| Other chains | token safety, token report and address safety on Ethereum and BSC (plus deployer check on Ethereum); token safety on Solana | $0.005–0.008 |
| Web | web_extract, link_preview, screenshot, robots_check (AI-crawler policy + llms.txt), headers_check |
$0.003–0.005 |
| SEO & search | seo_audit (SEO + GEO audit, per page), serp, backlinks, keyword_volume (up to 200 keywords per call), ranked_keywords, keyword_ideas |
$0.02–0.15 |
| Markets & finance | prediction_markets, defi_yields, quant |
$0.003–0.005 |
| LLM | chat (OpenAI-compatible, per-token + 3%), list_models (free) |
— |
Prices are indicative; the live 402 challenge is authoritative, and the server refuses to sign above
its per-call cap. Call list_models or read https://true402.dev/api/openapi.json for the exact set.
Install
Requires Node.js ≥ 20. Runs over stdio — point any MCP client at it via npx.
Claude Desktop / Claude Code
Add to your MCP config (claude_desktop_config.json, or .mcp.json for Claude Code):
{
"mcpServers": {
"true402": {
"command": "npx",
"args": ["-y", "@true402.dev/mcp-server"],
"env": {
"WALLET_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_WALLET_KEY"
}
}
}
}
Cursor / Cline / other MCP clients
Same idea — command npx, args ["-y", "@true402.dev/mcp-server"], and the WALLET_PRIVATE_KEY env var.
Configuration
| Env var | Default | Description |
|---|---|---|
SERVER_URL |
https://true402.dev/api |
true402 API base. Override to point at a self-hosted instance. |
WALLET_PRIVATE_KEY |
(none) | A funded Base wallet private key used to sign x402 payments. Needs USDC (gas is sponsored by the facilitator — no ETH required). Without it, paid tools return the 402 requirements instead of paying. |
MAX_PAYMENT_USDC |
0.25 |
Hard per-call spend ceiling in USDC. This server auto-discovers every paid stall the marketplace advertises (it walks the live OpenAPI spec, not a fixed list), so a new or repriced stall can appear above the default at any time — a call over the ceiling is refused (not paid, not crashed), and the refusal names the price and the ceiling. Raise it if a discovered tool's description shows a price close to or over your configured value; one stall (seo_audit) is priced per page and can itself exceed a typical ceiling on a large page. |
X402_ALLOW_NETWORKS |
(none) | Payments are signed for Base mainnet (eip155:8453) only; a 402 naming any other chain is refused. To also pay on Base Sepolia or Ethereum mainnet, list them as comma-separated CAIP-2 ids, e.g. eip155:84532,eip155:1. Unsupported entries are ignored. |
Security: the key is read only from the environment and is never logged, echoed, or returned. Use a dedicated low-balance wallet — fund it with only what you intend to spend.
How payment works
- The tool calls the true402 endpoint with no payment.
- The server replies
402with accepted payment options (USDC on Base). - This MCP server signs an EIP-3009
transferWithAuthorizationwith your wallet. - It retries with the signed payment in the
PAYMENT-SIGNATUREheader (x402 v2); the service verifies and responds. - Settlement happens on-chain. Your wallet pays only USDC — the facilitator sponsors gas.
When a newer release of this server exists, the first tool result of the session carries one extra line saying so, with the install command. Nothing is blocked; it is shown once per process.
Links
- Marketplace: https://true402.dev
- Free Telegram rug-check bot (no wallet): https://t.me/True402bot
- Live tool catalog: https://true402.dev/api/v1/services
- x402 protocol: https://x402.org
Guides
- The x402 protocol, explained
- x402 facilitators: what they do and which to use
- Fund a Base wallet for x402 (USDC only, no ETH)
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 402 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
true402 MCP questions
How do I add true402 MCP to Claude Code?
Run claude mcp add --env 'WALLET_PRIVATE_KEY=<YOUR_WALLET_PRIVATE_KEY>' mcp-server -- npx -y @true402.dev/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add true402 MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does true402 MCP provide?
It exposes 13 tools, including list_models, chat, seo_audit, web_extract, link_preview.
Do I need an API key to use this server?
No, the server uses a wallet-based identity system where the agent's wallet serves as its identity for micropayments.
What happens if I don't provide a funded wallet?
The server will still function, but paid tools will return the specific payment requirements instead of failing.
Do I need ETH to pay for tools?
No, you only need USDC on the Base network, as the facilitator sponsors the gas fees.
How does the server handle new tools being added to the marketplace?
Tools are automatically discovered from the live catalog at startup, meaning new tools appear without needing a package update.