# IPRout MCP Server

GeoIP and ASN intelligence for AI agents using the IPRout API.

This MCP server exposes IPRout lookup tools to MCP-compatible clients such as Claude Desktop and other agent runtimes.

## Tools

### lookup_ip

Lookup GeoIP and ASN information for a specific IPv4 or IPv6 address.

Input:

```json
{
  "ip": "8.8.8.8"
}
```

### lookup_caller_ip

Lookup GeoIP and ASN information for the caller IP as detected by IPRout.

Input:

```json
{}
```

## Requirements

- Node.js 18+
- IPRout API key

## Installation

```bash
npm install
```

## Environment

Create a `.env` file:

```env
IPROUT_API_KEY=your_api_key_here
IPROUT_API_BASE_URL=https://api.iprout.com
```

`IPROUT_API_BASE_URL` is optional. It defaults to `https://api.iprout.com`.

## Run locally

```bash
npm start
```

## Development

```bash
npm run dev
```

## Claude Desktop config example

Update your Claude Desktop MCP config:

```json
{
  "mcpServers": {
    "iprout": {
      "command": "node",
      "args": [
        "/absolute/path/to/iprout-mcp-server/src/index.js"
      ],
      "env": {
        "IPROUT_API_KEY": "your_api_key_here",
        "IPROUT_API_BASE_URL": "https://api.iprout.com"
      }
    }
  }
}
```

## Example prompts

```text
Lookup 8.8.8.8 using IPRout.
```

```text
What country, ASN, and organization owns 1.1.1.1?
```

```text
Lookup my current IP using IPRout.
```

## Authentication

The server sends your API key to IPRout using:

```http
X-API-Key: YOUR_API_KEY
```

## IPRout Resources

- Website: https://iprout.com
- Documentation: https://iprout.com/docs
- OpenAPI: https://iprout.com/docs/openapi.json
- Postman: https://documenter.getpostman.com/view/55991899/2sBXwtrASm
- Examples: https://github.com/IProut2026/examples

## License

MIT