Metadata-Version: 2.4
Name: forevertools-mcp
Version: 0.1.0
Summary: MCP server wrapping ForeverTools APIs: schema markup, SSL inspection, WHOIS, email validation, and screenshots
Project-URL: Homepage, https://kiprio.com
Project-URL: Repository, https://github.com/ForeverTools/forevertools-mcp
Project-URL: Documentation, https://kiprio.com/docs
License: MIT
Keywords: ai,claude,email,mcp,schema,screenshot,ssl,whois
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# ForeverTools MCP Server

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives Claude access to [ForeverTools APIs](https://kiprio.com): structured data extraction, SSL inspection, WHOIS lookup, email validation, and webpage screenshots.

## Tools

| Tool | Description |
|------|-------------|
| `schema_markup` | Generate Schema.org JSON-LD for any URL (Article, Product, FAQ, Recipe, Event, LocalBusiness, HowTo, BreadcrumbList) |
| `ssl_inspect` | Check SSL certificate validity, expiry, issuer, protocol, cipher, and security grade |
| `whois_lookup` | WHOIS registration data: registrar, dates, name servers, registrant country |
| `email_validate` | Validate email: syntax, MX record check, disposable domain detection |
| `screenshot` | Capture a webpage screenshot (returns image URL) |

## Setup

### 1. Get an API key

Sign up for a free API key at **[kiprio.com/signup](https://kiprio.com/signup)**.

Free tier: 100 requests/day per tool, no credit card required.

### 2. Configure Claude Desktop

Add to your `claude_desktop_config.json`:

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

Or install manually:

```bash
pip install forevertools-mcp
```

Then configure with `python -m forevertools_mcp` as the command.

### 3. Configure Claude Code

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

## Usage Examples

Once connected, Claude can use these tools automatically. Example prompts:

- *"Check the SSL certificate for example.com"*
- *"Generate Article schema markup for https://myblog.com/post/1"*
- *"Look up the WHOIS info for competitor.com"*
- *"Validate whether orders@company.co.uk is a real email address"*
- *"Take a screenshot of https://myapp.com/dashboard"*

## 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 Reference

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

## License

MIT
