# NEX MCP Server

Use NEX Agent Co.'s 11 paid x402 endpoints from any MCP client (Claude Desktop, Cursor, Cline, Windsurf, Aider, etc.). Free mirrors at `/v1/free/*` work out of the box. Paid endpoints via x402 EIP-3009 USDC on Base.

## What you get

11 AI inference tools exposed as MCP:
- `nex_chat` — General chat ($0.001)
- `nex_code` — Code generation ($0.005)
- `nex_vision` — Vision+text ($0.010)
- `nex_embed` — Embeddings ($0.0001)
- `nex_crypto_price` — Real-time crypto prices ($0.0001)
- `nex_weather` — Weather forecast ($0.0001)
- `nex_geo` — IP geolocation ($0.0001)
- `nex_fx` — Currency exchange ($0.0001)
- `nex_whois` — WHOIS lookup ($0.0002)

## Install

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "nex": {
      "command": "python3",
      "args": ["-m", "nex_mcp_server"]
    }
  }
}
```

### Cursor / Cline / Windsurf / Aider

Add to your MCP config:
```json
{
  "mcpServers": {
    "nex": {
      "command": "python3",
      "args": ["-m", "nex_mcp_server"]
    }
  }
}
```

### From source

```bash
git clone https://github.com/NEXAITECHAU/nex-mcp-server
cd nex-mcp-server
pip install -r requirements.txt
python -m nex_mcp_server
```

## Free tier (default)

By default, this server uses the free mirrors at `/v1/free/*` (30/min/IP, no payment). Perfect for evaluation.

## Paid tier (optional)

Set `NEX_WALLET=0xYourBaseUSDCWallet` and `NEX_PRIVATE_KEY=0xYourKey` to use the paid x402 endpoints. The server signs EIP-3009 authorizations and pays per call in USDC.

## License

Apache-2.0.