@true402.dev/mcp-server
Give an AI agent pay-per-call (x402, USDC on Base) access to LLM inference and Base on-chain / web-analysis tools — no accounts or API keys, just a funded wallet.
LLM inference:
chat(OpenAI-compatible completions across many models) and freelist_modelsfor live per-token pricing.Web/AI-visibility audits:
seo_audit(SEO + GEO report),robots_check(AI-crawler policy, sitemaps, llms.txt),headers_check(security headers + score).Page extraction:
web_extract(clean text/markdown/links/metadata) andlink_preview(Open Graph unfurl card).Token safety:
token_safety(rug/honeypot simulation, 0–100 score, liquidity depth) andtoken_report(all-in-one safety + liquidity-pull + whale activity with ok/caution/avoid verdict).Address & deployer risk:
address_safety(EOA vs contract, balances, proxy/mint/ownership flags) anddeployer_check(deployer reputation, fresh-throwaway detection).Market monitoring:
new_pairs(fresh Base DEX launches),liquidity_pulls(rug alerts),whale_swaps(large swaps / copy-trade signal).Payments: HTTP 402 challenges signed with an EIP-3009 USDC authorization; gas sponsored, spend ceiling via
MAX_PAYMENT_USDC, Base-only by default.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@true402.dev/mcp-servercheck token safety for 0x1f984"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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) |
| $0.005–0.008 |
Base history & flow |
| $0.003–0.005 |
Before you sign |
| $0.008 |
Full dossier |
| $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 |
| $0.003–0.005 |
SEO & search |
| $0.02–0.15 |
Markets & finance |
| $0.003–0.005 |
LLM |
| — |
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.
Related MCP server: x402-mcp
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 |
|
| true402 API base. Override to point at a self-hosted instance. |
| (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. |
|
| 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 ( |
| (none) | Payments are signed for Base mainnet ( |
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
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
Available Tools
36 toolsaddress_risk
Same check and price as the address-safety tool, under the name buyers search for. Structural safety profile for ANY Base address — an EOA or an arbitrary contract — before an agent sends funds to it, approves it, or calls it. Returns contract-vs-EOA, ETH + USDC balance, tx-count (activity), and for contracts: whether it is a recognised ERC-20, ownership state, a mint() selector, and whether it is an EIP-1967 upgradeable proxy (its logic can be swapped after you trust it). Coarse risk band + flags. On-chain reads only — no API key. POST { address }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'base' is supported (default) | |
| address | Yes | Any address (0x…) on Base — an EOA or a contract |
address_safety
Structural safety profile for ANY Base address — an EOA or an arbitrary contract — before an agent sends funds to it, approves it, or calls it. Returns contract-vs-EOA, ETH + USDC balance, tx-count (activity), and for contracts: whether it is a recognised ERC-20, ownership state, a mint() selector, and whether it is an EIP-1967 upgradeable proxy (its logic can be swapped after you trust it). Coarse risk band + flags. On-chain reads only — no API key. POST { address }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'base' is supported (default) | |
| address | Yes | Any address (0x…) on Base — an EOA or a contract |
address_safety_bsc
Structural safety profile for ANY BNB Smart Chain (BSC) address — an EOA or an arbitrary contract — before an agent sends funds to it, approves it, or calls it. Returns contract-vs-EOA, ETH + USDC balance, tx-count (activity), and for contracts: whether it is a recognised ERC-20, ownership state, a mint() selector, and whether it is an EIP-1967 upgradeable proxy (its logic can be swapped after you trust it). Coarse risk band + flags. On-chain reads only — no API key. POST { address }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'bsc' is supported on this endpoint (default) | |
| address | Yes | Any address (0x…) on BNB Smart Chain (BSC) — an EOA or a contract |
address_safety_ethereum
Structural safety profile for ANY Ethereum address — an EOA or an arbitrary contract — before an agent sends funds to it, approves it, or calls it. Returns contract-vs-EOA, ETH + USDC balance, tx-count (activity), and for contracts: whether it is a recognised ERC-20, ownership state, a mint() selector, and whether it is an EIP-1967 upgradeable proxy (its logic can be swapped after you trust it). Coarse risk band + flags. On-chain reads only — no API key. POST { address }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'ethereum' is supported on this endpoint (default) | |
| address | Yes | Any address (0x…) on Ethereum — an EOA or a contract |
backlinks
A domain's backlink profile: referring domains and pages, the dofollow split that carries authority, authority rank, spam score, broken backlinks, and link composition by TLD, type, attribute and country. POST { target }; unpaid returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.1 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | Domain, or any URL on it |
chatA
Send 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.
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | Model ID (e.g. gpt-4o, claude-3-5-sonnet) | |
| messages | Yes | Chat messages | |
| max_tokens | No | Maximum tokens to generate |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description carries the burden. It discloses payment requirement and wallet setup, but does not mention rate limits, error handling, or consequences of insufficient funds. The description partially covers behavior but leaves gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the primary action, and no wasted words. Every sentence adds necessary information about the service and prerequisite.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has 3 parameters (2 required), no output schema, and no annotations, the description is minimal. It covers the payment aspect but lacks details on model availability, response format, or error scenarios, making it incomplete for a transactional tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with detailed descriptions for each parameter (model, messages, max_tokens). The description adds no extra semantics beyond what the schema already provides, earning the baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool sends a chat completion request to an LLM via a specific paid service (true402). The verb 'send' and resource 'chat completion request' are explicit, and the service detail distinguishes it from sibling tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description mentions the paid nature and wallet requirement, providing context on when to use it (if funded). However, it lacks explicit guidance on when not to use it or alternatives, leaving the AI to infer from sibling tool names.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
defi_yields
Filter + rank live DeFi lending/staking pool APYs across every protocol/chain (DefiLlama, ~15k pools). POST { chain?, project?, asset?, stablecoinOnly?, minTvlUsd?, includeOutliers?, limit? }; returns pools sorted by APY (percent units, apyBase/apyReward split), TVL, stablecoin + ilRisk flags, and the DefiLlama poolId. Exploit-y outlier pools excluded by default. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. Flat-priced per request. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| asset | No | Case-insensitive substring match on the pool symbol | |
| chain | No | Filter by chain, case-insensitive (e.g. "Base") | |
| limit | No | Max pools, 1–50 (default 20), applied after sort | |
| project | No | Filter by protocol, case-insensitive (e.g. "aave-v3") | |
| minTvlUsd | No | Drop pools below this TVL (USD), ≥ 0 | |
| stablecoinOnly | No | Keep only stablecoin pools | |
| includeOutliers | No | Include DefiLlama outlier:true pools (default false) |
deployer_check
Resolves the deployer of a Base token and profiles that wallet's reputation: age (tx-count), balance, and whether it is a FRESH throwaway spun up for the launch (a common rug setup) — the discriminating caution. Reputation context a structural/honeypot check can't see. The creator is resolved from the chain itself (its creation receipt), so no explorer is needed. On Base the contracts-shipped count and deep mode are unavailable for now: both need an explorer's list of the contracts a wallet created, which Base lacks today, so contractsCreated comes back null and the answer's limits[] says so. POST { token }. Unpaid returns 402 — no free trial on this stall, it is paid from the first call. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.008 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| deep | No | Opt-in: also classify the deployer's recent prior tokens as live/dead (no liquidity = rug outcome). Slower; the real serial-rugger signal. | |
| chain | No | Chain to check; only 'base' is supported (default) | |
| token | Yes | Token contract address (0x…) on Base |
deployer_check_ethereum
Resolves the deployer of an Ethereum token and profiles that wallet's reputation: age (tx-count), balance, and whether it is a FRESH throwaway spun up for the launch (a common rug setup) — the discriminating caution. Reputation context a structural/honeypot check can't see. POST { token }. Unpaid returns 402 — no free trial on this stall, it is paid from the first call. Requires an explorer key on the server; returns 503 if not configured (and is not charged). (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.008 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| deep | No | Opt-in: also classify the deployer's recent prior tokens as live/dead (no liquidity = rug outcome). Slower; the real serial-rugger signal. | |
| chain | No | Chain to check; only 'ethereum' is supported on this endpoint (default) | |
| token | Yes | Token contract address (0x…) on Ethereum |
headers_check
Fetch a URL and analyse its HTTP security headers (HSTS, CSP, X-Frame-Options, …) into present/missing + a 0–100 score. POST { url }; unpaid returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.003 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The URL (http/https) |
honeypot
Same check and price as the token-safety tool, under the name buyers search for. Rug/honeypot safety check for an ERC-20 token on Base (from on-chain reads — no API key): ERC-20 conformance, ownership renounce, mint-capability, WETH/USDC liquidity depth across Uniswap V3 + Aerodrome, and a buy/sell honeypot simulation (a gas-free eth_call that round-trips a tiny WETH→token→WETH trade to detect tokens you can buy but not sell). Returns a 0–100 score + risk flags. POST { token }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | 'base' (default) | |
| token | Yes | ERC-20 contract address on Base |
keyword_ideas
Related and long-tail keyword ideas for a seed term, each with search volume, CPC, competition and search intent. POST { seed }; unpaid returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.05 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| seed | Yes | Seed keyword, max 80 chars | |
| limit | No | Ideas to return, 1-200, default 50 | |
| language | No | ||
| location | No |
keyword_volume
Monthly search volume, CPC and competition for a batch of keywords, with a 12-month trend per term. Send up to 200 keywords in ONE call — they are priced per call, not per keyword. POST { keywords }; unpaid returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.15 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | Yes | Up to 200 keywords, priced per call | |
| language | No | Language code, default 'en' | |
| location | No | Location code, default 2840 (US) |
link_preview
Fetch a URL and return its Open Graph card (title, description, image, site name, favicon, canonical). POST { url }; an unpaid request returns 402. Flat-priced per request. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.003 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The page URL (http/https) |
liquidity_history
Observed liquidity history for a Base token, from our own DEX archive. POST { token, limit? } returns every pool we have 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 coverage, the exact block range our removal index covers, so an absence of removals is never presented as a clean bill of health. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max removal events returned (1–200, default 50) | |
| token | Yes | Base token contract address (0x…) |
liquidity_pulls
Liquidity-pull / rug alerts on Base — Burn (liquidity-removal) events on recently-launched DEX pools (the new-pairs watcher's set). POST { since?, limit?, dex?, minQuote? }; each event gives the pool, token, and WETH/USDC amount removed (the rug magnitude). Cross-check the token with /v1/token-safety. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.003 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| dex | No | Filter: 'uniswap-v3' | 'aerodrome' | |
| limit | No | Max pulls (1–200, default 50) | |
| since | No | Only pulls first seen at or after this block | |
| minQuote | No | Only removals of at least this much WETH/USDC |
list_modelsA
List 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).
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It discloses return fields (id, provider, prices), pricing model (3% over cost, min fee), and payment method (x402). Missing details on pagination or limits, but acceptable for a listing tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single paragraph, front-loaded with purpose. Concise but could be slightly shorter. No wasted sentences.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema, but description details return values (id, provider, prices). Covers essential behavior. No obvious gaps given zero parameters.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Input schema has 0 parameters and schema description coverage is 100%. Description does not need to add param info; baseline 4 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool lists LLM models with live pricing, using specific verbs ('list', 'returns'). It distinguishes from sibling tools (e.g., chat, address_safety) which have unrelated purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Implied usage: when an agent needs to pick a model and know cost before paying. No explicit when-not or alternatives, but sibling tools are unrelated, so no confusion.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
new_pairs
Recently-created Base DEX pairs (Uniswap V3 + Aerodrome) from a background log-watcher — fresh token launches for trading agents/snipers. POST { since?, limit?, dex?, withToken? }; each pair gives the new token, quote (WETH/USDC), pool, fee|stable, block + approx age. Bundle with /v1/token-safety for a pre-trade rug/honeypot check. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.003 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| dex | No | Filter: 'uniswap-v3' | 'aerodrome' | |
| limit | No | Max pairs (1–200, default 50) | |
| since | No | Only pairs first seen at or after this block | |
| withToken | No | Only token launches (default true) |
prediction_markets
Keyword-search live prediction markets across Polymarket, Limitless, and Manifold; returns normalized markets (probability outcomes, USD volume, close date). POST { query, limit? }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. Flat-priced per request. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max markets returned across all venues, 1–50 (default 20) | |
| query | Yes | Keyword to search market questions |
quant
Deterministic finance calculators in one dispatch endpoint. POST { function, params } where function ∈ {black_scholes, implied_volatility, kelly, sharpe, sortino, max_drawdown, historical_var, cvar, cagr, volatility}. e.g. black_scholes params {S,K,T,r,sigma,type}; kelly {p,b}; sharpe {returns[],rf?}. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. Flat-priced per request. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.003 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes | Parameters for the chosen function | |
| function | Yes | Which calculator to run |
ranked_keywords
Which keywords a domain already ranks for in organic search, with position, search volume, CPC and competition. POST { target }; unpaid returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.05 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to return, 1-200, default 50 | |
| target | Yes | Domain, or any URL on it | |
| language | No | ||
| location | No |
robots_check
Fetch a site's robots.txt + llms.txt and report whether the major AI crawlers are allowed/blocked, plus sitemaps. POST { url }; unpaid returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.003 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Any URL on the site |
screenshot
Render a web page in headless Chromium and return a PNG screenshot as base64 JSON. POST { url, fullPage?, width? }; an unpaid request returns 402. Flat-priced per request. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.004 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The page URL to render (http/https) | |
| width | No | Viewport width 320–1920; default 1280 | |
| fullPage | No | Full-page capture (height clamped to 8000px); default false |
seo_audit
Audit web pages for SEO + GEO (generative-engine optimization). POST { url, mode? } for a single page, or { urls: [...], mode? } to audit several in one call — priced per page ($0.02/page, up to 10 pages per request on this deployment). An unpaid request returns 402 with payment requirements. After payment, a single url returns a flat report (per-category scores + issues); urls returns { count, succeeded, pages: [...] }. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.02–$0.2 USD/page (DYNAMIC — can exceed a fixed MAX_PAYMENT_USDC ceiling; raise it if a call is refused).
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | A single page URL to audit (http/https). Charged as 1 page. | |
| mode | No | Which analysis to run (default both) | |
| urls | No | Several page URLs to audit in one call (up to 20; this deployment prices at most 10 per request). Charged per page. |
serp
Live Google organic results for one query: the top 10–30 results with position, domain, URL, title and snippet, the SERP features present, and — with target — that domain's position (null = not in the results read). POST { keyword, target? }; unpaid returns 402. Paid from the first call (no free trial). (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.02 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | Results to read, 10-30, default 10 | |
| device | No | ||
| target | No | Optional domain (or any URL on it) whose position to report | |
| keyword | Yes | The search query | |
| language | No | Default "en" | |
| location | No | DataForSEO location code, default 2840 (United States) |
token_dossier
Everything we know about a Base ERC-20, in one call. Contains the full Token Report (ERC-20 conformance, ownership, mint-capability, liquidity depth, buy/sell honeypot simulation, live rug + whale activity, avoid|caution|ok verdict) PLUS two sections the cheaper report cannot carry: the deployer's reputation (wallet age, prior deployments) and the durable liquidity archive for this token (every pool, every removal with amount/block/tx, and the other tokens drained in the SAME transaction — operator linkage). Those two are what distinguish a bad token from a serial rugger. Each section reports its own status and limits[] names what could NOT be established, because a silently missing section reads as reassurance. The verdict is inherited from the Token Report and may only be escalated, never softened. POST { token }. No free trial on this stall. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.1 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'base' is supported (default) | |
| token | Yes | ERC-20 contract address (0x…) on Base |
token_report
The flagship composite for a Base ERC-20 — one call instead of five. Runs the full token-safety check (ERC-20 conformance, ownership, mint-capability, WETH/USDC liquidity depth, buy/sell honeypot simulation), enriches it with the live recent liquidity-removal (rug) + whale-swap activity on the token, and returns a single avoid|caution|ok verdict with reasons plus the underlying reports. POST { token }. Cheaper than buying token-safety + liquidity-pulls + whale-swaps separately. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.008 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'base' is supported (default) | |
| token | Yes | ERC-20 contract address (0x…) on Base |
token_report_bsc
The flagship composite for a BNB Smart Chain (BSC) ERC-20 — one call instead of five. Runs the full token-safety check (ERC-20 conformance, ownership, mint-capability, WBNB/USDC liquidity depth, buy/sell honeypot simulation), and returns a single avoid|caution|ok verdict with reasons plus the underlying reports. POST { token }. Cheaper than buying token-safety + liquidity-pulls + whale-swaps separately. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. Recent liquidity-removal and whale-swap activity is tracked on Base only, so recentPulls and recentWhaleSwaps are always empty on this chain. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.008 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'bsc' is supported on this endpoint (default) | |
| token | Yes | ERC-20 contract address (0x…) on BNB Smart Chain (BSC) |
token_report_ethereum
The flagship composite for an Ethereum ERC-20 — one call instead of five. Runs the full token-safety check (ERC-20 conformance, ownership, mint-capability, WETH/USDC liquidity depth, buy/sell honeypot simulation), and returns a single avoid|caution|ok verdict with reasons plus the underlying reports. POST { token }. Cheaper than buying token-safety + liquidity-pulls + whale-swaps separately. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. Recent liquidity-removal and whale-swap activity is tracked on Base only, so recentPulls and recentWhaleSwaps are always empty on this chain. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.008 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'ethereum' is supported on this endpoint (default) | |
| token | Yes | ERC-20 contract address (0x…) on Ethereum |
token_safety
Rug/honeypot safety check for an ERC-20 token on Base (from on-chain reads — no API key): ERC-20 conformance, ownership renounce, mint-capability, WETH/USDC liquidity depth across Uniswap V3 + Aerodrome, and a buy/sell honeypot simulation (a gas-free eth_call that round-trips a tiny WETH→token→WETH trade to detect tokens you can buy but not sell). Returns a 0–100 score + risk flags. POST { token }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | 'base' (default) | |
| token | Yes | ERC-20 contract address on Base |
token_safety_bsc
Rug/honeypot safety check for an ERC-20 token on BNB Smart Chain (BSC) (from on-chain reads — no API key): ERC-20 conformance, ownership renounce, mint-capability, WBNB/USDC liquidity depth across pancakeswap-v3 + pancakeswap-v2, and a buy/sell honeypot simulation (a gas-free eth_call that round-trips a tiny WETH→token→WETH trade to detect tokens you can buy but not sell). Returns a 0–100 score + risk flags. POST { token }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'bsc' is supported on this endpoint (default) | |
| token | Yes | ERC-20 contract address on BNB Smart Chain (BSC) |
token_safety_ethereum
Rug/honeypot safety check for an ERC-20 token on Ethereum (from on-chain reads — no API key): ERC-20 conformance, ownership renounce, mint-capability, WETH/USDC liquidity depth across uniswap-v3 + uniswap-v2, and a buy/sell honeypot simulation (a gas-free eth_call that round-trips a tiny WETH→token→WETH trade to detect tokens you can buy but not sell). Returns a 0–100 score + risk flags. POST { token }. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'ethereum' is supported on this endpoint (default) | |
| token | Yes | ERC-20 contract address on Ethereum |
token_safety_solana
Rug/trap safety check for a Solana SPL or Token-2022 token: mint authority (supply inflation), freeze authority (the Solana honeypot — the issuer can freeze your token account so you cannot sell), Token-2022 extensions (permanentDelegate = tokens can be moved out of your wallet, transferHook = issuer code can reject your transfer, transferFee) and pool liquidity depth. Returns a 0–100 score + risk flags. POST { token } with a base58 mint. NOT a buy/sell simulation: Solana has no EVM bytecode, so the eth_call round-trip the Base/Ethereum/BSC stalls run does not exist here. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain to check; only 'solana' is supported on this endpoint (default) | |
| token | Yes | SPL mint address (base58) on Solana |
tx_preflight
Check a Base transaction BEFORE signing it. POST an UNSIGNED transaction { from, to, data?, value? } and get three independent lenses: simulation against current state (does it revert?), decoded intent (is this an unlimited approval that outlives the trade?), and the counterparty liquidity-removal history from our own archive. Takes NO private key and NO signature, so the service cannot broadcast or front-run the transaction it inspects — a deliberate security property. It never returns "safe": a clean result means these checks found nothing, and the limits array says so in every response. Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.008 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Destination contract or address | |
| data | No | Calldata hex (0x…); omit for a plain native transfer | |
| from | Yes | Sender address. Asserted, never proven — no signature is taken. | |
| value | No | Native value in wei as a decimal string; default 0 |
web_extract
Fetch a web page and return clean readable text + light markdown + title/description/links. POST { url }; an unpaid request returns 402. Flat-priced per request. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The page URL to extract (http/https) |
whale_swaps
Recent large ($-value) DEX Swap events (Uniswap V3 + Aerodrome) on the Base pools the new-pairs watcher tracks — a whale-following / copy-trading signal. POST { min?, dex?, since?, limit?, direction? }; each swap gives the pool, token, quote (WETH/USDC), USD size, direction (buy/sell of the token), block + approx age, txHash. usdValue is the quote side (WETH×ETH-USD or USDC). Unpaid: free while the caller's IP has free-trial calls left that day (a small daily allowance shared across the trial stalls, no wallet); otherwise returns 402. (PAID x402 service — USDC on Base; the MCP server needs a funded wallet to settle.) Price: $0.005 USD (fixed).
| Name | Required | Description | Default |
|---|---|---|---|
| dex | No | Filter: 'uniswap-v3' | 'aerodrome' | |
| min | No | Only swaps of at least this USD size (default 10000) | |
| limit | No | Max swaps (1–200, default 50) | |
| since | No | Only swaps at or after this block | |
| direction | No | Filter: 'buy' | 'sell' (of the non-quote token) |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
23 tool updates
v1.3.0- Added
address_risk - Added
address_safety_bsc - Added
address_safety_ethereum - Added
backlinks - Added
defi_yields - Added
deployer_check_ethereum - Added
honeypot - Added
keyword_ideas - Added
keyword_volume - Added
liquidity_history - Added
prediction_markets - Added
quant - Added
ranked_keywords - Added
screenshot - Changed
seo_audit3 fields changed- changed
Input schema / properties / url / descriptionPrevious value: -"The page URL to audit (http/https)"New value: +"A single page URL to audit (http/https). Charged as 1 page." - added
Input schema / properties / urlsAdded value: +{ + "description": "Several page URLs to audit in one call (up to 20; this deployment prices at most 10 per request). Charged per page.", + "items": {}, + "type": "array" +} - removed
Input schema / requiredRemoved value: -[ - "url" -]
- Added
serp - Added
token_dossier - Added
token_report_bsc - Added
token_report_ethereum - Added
token_safety_bsc - Added
token_safety_ethereum - Added
token_safety_solana - Added
tx_preflight
5 tool updates
v1.0.0- Added
address_safety - Added
deployer_check - Changed
liquidity_pulls1 field changed- added
Input schema / properties / dex / enumAdded value: +[ + "uniswap-v3", + "aerodrome" +]
- Changed
new_pairs1 field changed- added
Input schema / properties / dex / enumAdded value: +[ + "uniswap-v3", + "aerodrome" +]
- Changed
whale_swaps2 fields changed- added
Input schema / properties / dex / enumAdded value: +[ + "uniswap-v3", + "aerodrome" +] - added
Input schema / properties / direction / enumAdded value: +[ + "buy", + "sell" +]
12 tool updates
v0.7.1- First observed
chat - First observed
headers_check - First observed
link_preview - First observed
liquidity_pulls - First observed
list_models - First observed
new_pairs - First observed
robots_check - First observed
seo_audit - First observed
token_report - First observed
token_safety - First observed
web_extract - First observed
whale_swaps
TDQS
Scored across 14 tools
Each tool targets a distinct operation: address safety, deployer reputation, web checks, token analysis, on-chain monitoring, and LLM inference. There is no functional overlap between any two tools.
Most tools use a descriptive verb_noun pattern (e.g., address_safety, token_report). The exception is 'chat', which breaks the pattern but is still clear and functional.
14 tools is well-scoped for a server covering blockchain safety, web diagnostics, and LLM services. Each tool addresses a specific need without unnecessary redundancy.
The set covers the full lifecycle of its domain: individual checks (address, token, deployer), aggregated reports (token_report), on-chain monitoring (new_pairs, liquidity_pulls, whale_swaps), web analysis (link_preview, seo_audit, headers_check, robots_check), and LLM capabilities (chat, list_models). No obvious gaps.
Maintenance
Related MCP Connectors
Monetize any MCP server: x402 paywall, pay-per-call billing in USDC on Base, agent marketplace.
15 paid AI agent primitives via x402 (USDC on Base). Pay-per-call MCP server.
Programmatic web-scraping MCP server powered by x402 micro-transactions on Base.
Agent-commerce MCP server for x402/USDC payments and affiliate splits on Base.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that lets your AI coding agent (Claude Code, OpenClaw, Codex, Cursor, etc.) discover and pay on-chain agents registered on ERC-8004, using Coinbase's official x402 protocol. No smart account. No bundler. No relay. Just your EOA, an HTTPS request, and an automatic 402 → sign → retry flow.35MIT
- AlicenseCqualityFmaintenanceMCP server bringing 100+ x402-paid APIs to AI agents (Claude, Cursor, MCP-aware clients). Auto-discovers tools from CDP Bazaar; handles USDC micropayments on Base.10020 npm1MIT
- AlicenseBqualityDmaintenanceMCP server providing AI agents access to 38 pay-per-call APIs (LLM, image, code, audio, crypto, web, IPFS) via HTTP 402 micropayments in USDC/USDm.2298 npm1MIT
- FlicenseAqualityBmaintenanceMCP server for a live x402 payment gateway on Base (USDC). Lets AI agents discover, preview for free, then pay per call — with prepaid gasless payments, signed receipts, and delta delivery.7-