# GORZ MCP server

Solana memecoin safety checks for AI assistants and trading agents.

Ask your assistant "is this coin safe?" and it checks the coin with [GORZ](https://gorz.app). You get the grade, every red flag with its reason, launch bundles, wallets selling in the same second, and links to known rug farms.

GORZ reports what public on-chain data shows. It does not predict prices, and nothing it returns is financial advice.

## Tools

| Tool | What it does | Key needed |
|---|---|---|
| `gorz_check_coin` | Full safety read for a coin by its mint address. Includes the grade (safer / caution / risky / checking), hard stops, red flags, launch bundle, same-second sellers, rug-farm link, AI dump warning, and what happened in the hour after GORZ first graded it. | No |
| `gorz_search_coins` | Find coins by ticker or name (`$BONK`, `fuzzy bear`). Returns their addresses and first GORZ grade. | No |
| `gorz_check_wallet` | What GORZ has seen a wallet do: rug-farm group, launch bundles, snipes, and its record as a coin creator. | Yes |

## Install

Requires Node.js 18 or newer.

### Claude Desktop, Cursor and other MCP clients

Add this to your MCP config (for Claude Desktop that's `claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "gorz": {
      "command": "npx",
      "args": ["-y", "gorz-mcp"],
      "env": { "GORZ_API_KEY": "" }
    }
  }
}
```

Leave `GORZ_API_KEY` empty to use the free tier.

### Claude Code

```
claude mcp add gorz -- npx -y gorz-mcp
```

## Limits and keys

| Plan | Checks per day | Price |
|---|---|---|
| Free | 300, no key | $0 |
| Starter | 20,000, plus wallet lookups | $49 / 30 days |
| Pro | 200,000 | $199 / 30 days |

Get a key at [gorz.app/developers](https://gorz.app/developers), paid in SOL or USDC. GORZ is also on RapidAPI, where you can pay by card.

## Settings

| Variable | Default | Purpose |
|---|---|---|
| `GORZ_API_KEY` | (empty) | Your GORZ key, for higher limits and wallet lookups |
| `GORZ_API_URL` | `https://gorz.app/api/v1` | Only change this for testing |

## Example

> **You:** Is 2DtF5QVs1zPwpZVR7PGiCcnNsi36gJvMWxNbeDVCpump safe to buy?
>
> **Assistant** (after calling `gorz_check_coin`): GORZ first graded $YMB as risky at a $585K market cap, and it dumped within the hour…

## License

MIT