# mcp-base-token-audit

ERC-20 honeypot check and swap route data — a single-purpose [MCP](https://modelcontextprotocol.io) server for AI agents. No install, no account: it runs as a remote server; this repo also has a zero-dependency stdio bridge.

```
https://angel.oroboros-design.com/mcp/base-token-audit
```

## Use it

**Claude Code**

```bash
claude mcp add --transport http base-token-audit https://angel.oroboros-design.com/mcp/base-token-audit
```

**Claude Desktop, Cursor, Windsurf, VS Code** (remote server)

```json
{ "mcpServers": { "base-token-audit": { "url": "https://angel.oroboros-design.com/mcp/base-token-audit" } } }
```

**Any stdio client** (Node 18+)

```json
{ "mcpServers": { "base-token-audit": { "command": "npx", "args": ["-y", "github:daoudandiaye98-alt/mcp-base-token-audit"] } } }
```

Then ask your agent, for example: *Before swapping 10 USDC into 0x… on Base, run token_risk; only if the risk is low, ask get_swap_route for the transaction.*

## Tools

| Tool | Price | What it does |
|---|---|---|
| `token_risk` | 3 free calls per agent, then 0.99 USDC | Reads the contract: upgradeable proxy (EIP-1967, beacon, clone), owner powers in the bytecode (mint, pause, blacklist, fee or max-tx setters, trading switch, burn from any address), owner renounced or active and owner share of supply. Risk `low`, `medium` or `high` with reasons. |
| `get_swap_route` | free | Best route on Base or Ethereum (KyberSwap, 0x as fallback): quote, minimum out, approval target and, with `taker`, the unsigned transaction your agent signs and sends itself. |
| `buy_pack_with_card` | — | Prepaid calls by card (Stripe) when the free calls are used up. |

## Paying

The first 3 paid calls per agent are free (identify your agent with the header `X-API-Key`, or set `ANGEL_API_KEY` for the stdio bridge). After that each call is paid per request in USDC on Base via [x402](https://x402.org) (`params._meta["x402/payment"]`), with a prepaid pack (`bundle_token`) or by card (`buy_pack_with_card`). The 402 answer names the exact amount and the pay-to address before anything is signed.

Angel is a technical data and risk-analysis service only: no custody, no execution or transmission of orders, no investment advice. The disclosed 0.5 % integrator fee is a technical API provisioning fee for computing the route data; the aggregator deducts it inside a swap you send yourself. Signals from on-chain code — sell restrictions that only trigger during a trade are not simulated.

## More

- Same checks as a library: `npm i angel-agent-guard` · `pip install angel-agent-guard` ([angel-agent-guard](https://github.com/daoudandiaye98-alt/angel-agent-guard))
- All of Angel's tools in one server: `https://angel.oroboros-design.com/agenten/signal/mcp` · A2A agent card: `https://angel.oroboros-design.com/.well-known/agent.json`
- MCP Registry: `com.oroboros-design.angel/base-token-audit`

Operated by Oroboros Design (Köln, Germany). MIT licence for the code in this repo.