forevertools-mcp 0.1.0__py3-none-any.whl

.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.env
+*.egg
+.venv/
+venv/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ForeverTools
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

PKG-INFO

@@ -0,0 +1,102 @@
+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

README.md

@@ -0,0 +1,81 @@
+# 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

forevertools_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,102 @@
+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

forevertools_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+./.gitignore,sha256=FDagvulEqWnMHZkxgkRCZDOEtwDfB6_WkNbwOZTRCZM,72
+./LICENSE,sha256=zuexm1RfSyxH1L1W1xkQBX7I8zgYjFCvGS3gQDmx8h8,1069
+./PKG-INFO,sha256=JGP_Ujfu4QU4GxHq2tuvtups0MuLIWOih1EKFlkFS-w,3094
+./README.md,sha256=ogqU_VDA1fDzj6TbQNjsdJggsYLxJe01azA1CwGyPeI,2216
+./pyproject.toml,sha256=o9idkyjR4muJ4QzO2wrG9yLnqmrut7AYwdo0dzDmvgo,1074
+./server.py,sha256=deZCMYcWgal1XMZ0k712l-TuGFCvX6EZdY6jOcD8WJs,5677
+forevertools_mcp-0.1.0.dist-info/METADATA,sha256=JGP_Ujfu4QU4GxHq2tuvtups0MuLIWOih1EKFlkFS-w,3094
+forevertools_mcp-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+forevertools_mcp-0.1.0.dist-info/entry_points.txt,sha256=f3htNxgIL9nqf6nsl82gD1nzNXWTfaVmkw3GKYVCd8M,52
+forevertools_mcp-0.1.0.dist-info/RECORD,,

forevertools_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

forevertools_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+forevertools-mcp = server:mcp.run

pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "forevertools-mcp"
+version = "0.1.0"
+description = "MCP server wrapping ForeverTools APIs: schema markup, SSL inspection, WHOIS, email validation, and screenshots"
+readme = "README.md"
+license = { text = "MIT" }
+license-files = []
+requires-python = ">=3.10"
+keywords = ["mcp", "claude", "ai", "schema", "ssl", "whois", "email", "screenshot"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.25.0",
+]
+
+[project.scripts]
+forevertools-mcp = "server:mcp.run"
+
+[project.urls]
+Homepage = "https://kiprio.com"
+Repository = "https://github.com/ForeverTools/forevertools-mcp"
+Documentation = "https://kiprio.com/docs"
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]

server.py

@@ -0,0 +1,177 @@
+"""ForeverTools MCP Server — wraps kiprio.com API endpoints for Claude."""
+
+import os
+import json
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+BASE_URL = "https://kiprio.com/v1"
+
+mcp = FastMCP(
+    "ForeverTools",
+    instructions="Structured data extraction, SSL inspection, WHOIS lookup, email validation, and screenshot tools powered by kiprio.com",
+)
+
+
+def _api_key() -> str:
+    key = os.environ.get("FOREVERTOOLS_API_KEY", "")
+    if not key:
+        raise ValueError(
+            "FOREVERTOOLS_API_KEY not set. Get a free key at https://kiprio.com/signup"
+        )
+    return key
+
+
+def _headers() -> dict:
+    return {"X-API-Key": _api_key(), "Accept": "application/json"}
+
+
+@mcp.tool()
+async def schema_markup(url: str, schema_type: str = "Article") -> str:
+    """Generate Schema.org structured data (JSON-LD) for a URL.
+
+    Supported types: Article, Product, FAQ, Recipe, Event, LocalBusiness, HowTo, BreadcrumbList.
+    Returns the JSON-LD script tag ready to embed in HTML, plus the raw schema object.
+
+    Args:
+        url: The page URL to generate schema markup for.
+        schema_type: Schema.org type. Defaults to "Article".
+    """
+    valid_types = ["Article", "Product", "FAQ", "Recipe", "Event", "LocalBusiness", "HowTo", "BreadcrumbList"]
+    if schema_type not in valid_types:
+        return json.dumps({"error": f"schema_type must be one of: {', '.join(valid_types)}"})
+
+    async with httpx.AsyncClient(timeout=15) as client:
+        resp = await client.post(
+            f"{BASE_URL}/schema/generate",
+            headers=_headers(),
+            json={"url": url, "type": schema_type},
+        )
+        data = resp.json()
+
+    if not data.get("ok"):
+        return json.dumps({"error": data.get("error", "Unknown error"), "url": url})
+
+    return json.dumps({
+        "url": url,
+        "type": schema_type,
+        "schema": data.get("schema"),
+        "json_ld": data.get("json_ld"),
+    }, indent=2)
+
+
+@mcp.tool()
+async def ssl_inspect(domain: str) -> str:
+    """Inspect a domain's SSL/TLS certificate details.
+
+    Returns certificate validity, expiry date, days remaining, issuer, SANs,
+    protocol version, cipher suite, and security grade.
+
+    Args:
+        domain: Domain to inspect (e.g. "example.com"). Strips https:// if present.
+    """
+    domain = domain.strip().lower().removeprefix("https://").removeprefix("http://").split("/")[0]
+
+    async with httpx.AsyncClient(timeout=15) as client:
+        resp = await client.get(
+            f"{BASE_URL}/ssl",
+            headers=_headers(),
+            params={"domain": domain},
+        )
+        data = resp.json()
+
+    if "error" in data:
+        return json.dumps({"error": data["error"], "domain": domain})
+
+    return json.dumps({
+        "domain": data.get("domain", domain),
+        "valid": data.get("valid"),
+        "expires_at": data.get("expires_at"),
+        "days_remaining": data.get("days_remaining"),
+        "issuer": data.get("issuer"),
+        "subject": data.get("subject"),
+        "sans": data.get("sans", []),
+        "protocol": data.get("protocol"),
+        "cipher": data.get("cipher"),
+        "grade": data.get("grade"),
+    }, indent=2)
+
+
+@mcp.tool()
+async def whois_lookup(domain: str) -> str:
+    """Look up WHOIS registration data for a domain.
+
+    Returns registrar, registration date, expiry date, name servers,
+    registrant country, and DNSSEC status.
+
+    Args:
+        domain: Domain to look up (e.g. "example.com").
+    """
+    domain = domain.strip().lower().removeprefix("https://").removeprefix("http://").split("/")[0]
+
+    async with httpx.AsyncClient(timeout=20, follow_redirects=True) as client:
+        resp = await client.get(
+            f"{BASE_URL}/whois",
+            headers=_headers(),
+            params={"domain": domain},
+        )
+        data = resp.json()
+
+    if "error" in data:
+        return json.dumps({"error": data["error"], "domain": domain})
+
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+async def email_validate(email: str) -> str:
+    """Validate an email address: syntax, MX records, and disposable domain check.
+
+    Returns whether the email is valid, has working MX records, is from a
+    disposable/temporary domain, and a recommendation (accept/reject/review).
+
+    Args:
+        email: Email address to validate (e.g. "user@example.com").
+    """
+    async with httpx.AsyncClient(timeout=15, follow_redirects=True) as client:
+        resp = await client.get(
+            f"{BASE_URL}/email-validate",
+            headers=_headers(),
+            params={"email": email},
+        )
+        data = resp.json()
+
+    if "error" in data:
+        return json.dumps({"error": data["error"], "email": email})
+
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+async def screenshot(url: str, width: int = 1280, height: int = 800) -> str:
+    """Capture a screenshot of a webpage and return the image URL.
+
+    Renders the page at the specified viewport size using a headless browser.
+    Returns a URL to the screenshot image (PNG, hosted temporarily).
+
+    Args:
+        url: The webpage URL to screenshot.
+        width: Viewport width in pixels. Defaults to 1280.
+        height: Viewport height in pixels. Defaults to 800.
+    """
+    async with httpx.AsyncClient(timeout=30, follow_redirects=True) as client:
+        resp = await client.get(
+            f"{BASE_URL}/screenshot",
+            headers=_headers(),
+            params={"url": url, "width": width, "height": height},
+        )
+        data = resp.json()
+
+    if "error" in data:
+        return json.dumps({"error": data["error"], "url": url})
+
+    return json.dumps(data, indent=2)
+
+
+if __name__ == "__main__":
+    mcp.run()