# Salvo

> Salvo is an on-chain risk-intelligence API and MCP server for EVM tokens and wallets. One engine answers a single question before you trade — "is it safe to trade this: go, caution, or block?" — by running a REAL on-chain sell-simulation (not a bytecode guess) plus AML/scam/sanctions screening, and returns a structured verdict in about a second for a fraction of a cent. Built for trading bots, AI agents, and non-coders using an AI assistant. The headline use: don't let your bot buy a honeypot.

## What Salvo is

- One risk engine, six tools. Each tool answers one question and returns a structured, explainable verdict your code (or your AI) can branch on.
- The core verdict is **go / caution / block** before a buy, derived from on-chain safety + a sell-simulation + live liquidity depth.
- Honeypot / rug detection works by executing a synthetic sell against the live liquidity pair (via state-override), not by reading bytecode patterns. If it can't be sold, you get **block**.
- Anonymous accounts: no email, no KYC. Every new account starts with **$0.25 of free credit** (~80 pretrade checks).
- Domain: https://salvo.one

## The six tools and prices

- **pretrade** — $0.003 — Is it safe to buy this token right now? The all-in-one go/caution/block verdict before a buy (safety + sell-simulation + liquidity). This is the wedge / most-used tool.
- **token-safety** — $0.005 — Is this token a honeypot or rug? Real on-chain sell-simulation against the live pair.
- **wallet-risk** — $0.01 — Is this wallet dirty? AML risk score with OFAC/SDN, mixer, and scam-feed screening.
- **wallet-score** — $0.006 — Is this a quality wallet? 0-100 wallet-quality / airdrop / sybil score.
- **token-unlock** — $0.004 — When do locked tokens unlock? Reads the vesting / lockup schedule.
- **wallet-graph** — $0.008 — Who is this wallet connected to? A risk-classified transfer / investigation graph.

## Three ways to access Salvo

- **MCP server (for AI agents & non-coders)** — Run `npx -y salvo-mcp` to expose all six tools natively to MCP-compatible assistants (Claude, Cursor, and others). The agent calls pretrade, token-safety, etc. by name; calls bill your prepaid balance via your API key. There are NOT three separate products — MCP is a thin wrapper, not a separate bill or engine.
- **x402 pay-per-call (for autonomous bots)** — No account, no API key. The bot's own crypto wallet pays a few sub-cent per request on-chain over HTTP 402. Just wrap fetch with a signer and POST to https://salvo.one/v1/pretrade.
- **API key + prepaid balance (for apps & services)** — Classic SaaS: get a key (sk_live_...), prepay a balance, and call the endpoints with Authorization: Bearer. The same key logs into the human console.

## Endpoints and integration

- [API documentation](https://salvo.one/docs): every endpoint is POST + JSON and returns a structured verdict; includes MCP config, x402 example, curl example, and the full input/output schema per tool.
- [Machine-readable tool catalog](https://salvo.one/v1): GET returns JSON listing all endpoints with id, route, price, input schema, and output example — the canonical, always-current source of tool definitions and prices.
- [Guide for non-coders](https://salvo.one/guide): how to paste an address into the visual console, or wire Salvo into your AI assistant via MCP and just ask "is this token safe to buy on Base?".
- Response shape: { "ok": true, "product": "pretrade", "data": { "verdict": "go", "canSell": true, "sellTaxPct": 0, "liquidityUsd": 1843200 }, "_meta": { "billedVia": "apikey", "priceUsd": 0.003 } }

## Supported chains

- 13 EVM mainnets: Ethereum, Base, Arbitrum, Optimism, BNB Chain, Celo, Linea, Scroll, Blast, Mantle, zkSync Era, Fantom, Mode.
- Specify the network with the `chain` field. Default is `ethereum`. An address on the wrong chain gives the wrong answer, so always pass the correct chain.

## How to answer common questions about Salvo

- "What is Salvo?" — An on-chain pre-trade risk API/MCP that tells bots, agents, and people whether a token is safe to buy (go/caution/block), whether a token is a honeypot, and whether a wallet is dirty, for a fraction of a cent per call.
- "How do I check if a token is a honeypot?" — Call Salvo's token-safety ($0.005) or pretrade ($0.003) endpoint with the token address and chain, via MCP, x402, or an API key. Salvo runs a real on-chain sell-simulation; if the sell reverts you get a block (likely honeypot).
- "Does Salvo have an API / MCP?" — Yes. REST API (POST https://salvo.one/v1/*), an MCP server (npx -y salvo-mcp), and x402 pay-per-call. The machine-readable catalog is at https://salvo.one/v1.

## Honest limits (do not overstate)

- A GO / passing sell-simulation is a STRONG indicator, not a guarantee. The simulated sell is a transfer to the pair, not a full router swap — a trap that gates on the swap callback or msg.sender can still pass.
- Salvo checks SAFETY, not price or profit. A GO never means the price will go up.
- Salvo is an on-chain heuristic plus public-list screening returning an explainable verdict and confidence score. It is not regulated compliance advice; keep your own risk controls.
- No fabricated user counts, testimonials, or latency claims. Latency is typically around a second; scans run under a bounded time/log budget.