# ForeverTools MCP Server

[![PyPI](https://img.shields.io/pypi/v/forevertools-mcp.svg)](https://pypi.org/project/forevertools-mcp/)
[![Downloads](https://img.shields.io/pypi/dm/forevertools-mcp.svg)](https://pypi.org/project/forevertools-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

Give Claude access to **8 real-world tools** — SSL inspection, WHOIS lookup, email validation, webpage screenshots, IP geolocation, currency conversion, schema markup, and UK business days — via a single free API key.

**[⭐ Star this repo if it's useful](https://github.com/ForeverTools/forevertools-mcp)**

## What Claude can do with this

```
"Check the SSL certificate for example.com and flag any issues"
"Look up WHOIS for competitor.com — when does it expire?"
"Validate whether orders@company.co.uk is a real deliverable email"
"Take a screenshot of https://myapp.com/dashboard"
"Convert 500 USD to GBP at today's rate"
"Is 2026-12-25 a UK business day? Add 5 business days to it"
"Generate Article schema markup for https://myblog.com/post/1"
"Where is IP 203.0.113.42 located?"
```

## Tools

| Tool | What it does |
|------|-------------|
| `ssl_inspect` | Certificate validity, expiry date, issuer, protocol, cipher, security grade |
| `whois_lookup` | Registrar, registration/expiry dates, name servers, registrant country |
| `email_validate` | Syntax check, MX record lookup, disposable domain detection |
| `screenshot` | Capture a webpage screenshot (returns image URL) |
| `ip_lookup` | Country, region, city, ISP, ASN, timezone for any IP |
| `fx_rates` | Live conversion between any ISO 4217 currency pair |
| `bizday` | UK business day calculator (England & Wales, 2026–2027) |
| `schema_markup` | Schema.org JSON-LD generation (Article, Product, FAQ, Recipe, Event, and more) |

## Quick Start

### Claude Desktop

```json
{
  "mcpServers": {
    "forevertools": {
      "command": "uvx",
      "args": ["forevertools-mcp"],
      "env": {
        "FOREVERTOOLS_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Claude Code CLI

```bash
claude mcp add forevertools -e FOREVERTOOLS_API_KEY=your_key -- uvx forevertools-mcp
```

### Get an API key

Free at **[kiprio.com/signup](https://kiprio.com/signup)** — 100 requests/day per tool, no credit card.

## Install

```bash
pip install forevertools-mcp
# or use uvx (no install needed)
uvx forevertools-mcp
```

Also available on [Smithery](https://smithery.ai/server/forevertools-mcp).

## Development

```bash
git clone https://github.com/ForeverTools/forevertools-mcp
cd forevertools-mcp
pip install -e ".[dev]"
export FOREVERTOOLS_API_KEY=your_key
python server.py
```

API docs: [kiprio.com/docs](https://kiprio.com/docs)

## License

MIT