agentrender-mcp 0.1.0__py3-none-any.whl

agentrender_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""AgentRender MCP stdio server — screenshot, pdf, extract."""
+
+__version__ = "0.1.0"

agentrender_mcp/server.py

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""AgentRender MCP server (stdio) — tools: screenshot, pdf, extract.
+
+Calls the AgentRender HTTP API. Configure:
+
+  AGENTRENDER_BASE_URL   default https://api.agentrenderapi.com
+  AGENTRENDER_API_KEY    Bearer token (required for production)
+
+Run (stdio):
+
+  export AGENTRENDER_API_KEY=akr_…
+  python -m agentrender_mcp.server
+"""
+
+from __future__ import annotations
+
+import base64
+import os
+from typing import Any
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP(
+    "agentrender",
+    instructions=(
+        "AgentRender tools: capture URL screenshots/PDFs and extract main content. "
+        "Set AGENTRENDER_API_KEY and optionally AGENTRENDER_BASE_URL "
+        "(default https://api.agentrenderapi.com)."
+    ),
+)
+
+
+def _base_url() -> str:
+    return os.getenv("AGENTRENDER_BASE_URL", "https://api.agentrenderapi.com").rstrip("/")
+
+
+def _api_key() -> str:
+    key = os.getenv("AGENTRENDER_API_KEY", "").strip()
+    if key:
+        return key
+    raw = os.getenv("RENDER_API_KEYS", "").strip()
+    if raw:
+        return raw.split(",")[0].strip()
+    return ""
+
+
+def _headers() -> dict[str, str]:
+    headers = {
+        "Content-Type": "application/json",
+        "Accept": "application/json",
+    }
+    key = _api_key()
+    if key:
+        headers["Authorization"] = f"Bearer {key}"
+    return headers
+
+
+def _post(path: str, body: dict[str, Any], *, timeout: float = 90.0) -> dict[str, Any]:
+    if not _api_key():
+        raise RuntimeError(
+            "AGENTRENDER_API_KEY is not set. Get a key via https://agentrenderapi.com "
+            "or your waitlist welcome email."
+        )
+    url = f"{_base_url()}{path}"
+    with httpx.Client(timeout=timeout) as client:
+        resp = client.post(url, json=body, headers=_headers())
+        try:
+            data = resp.json()
+        except Exception:
+            data = {"ok": False, "error": {"code": "bad_response", "message": resp.text[:500]}}
+        if resp.status_code >= 400:
+            err = data.get("error") if isinstance(data, dict) else None
+            msg = err.get("message") if isinstance(err, dict) else resp.text[:300]
+            raise RuntimeError(f"HTTP {resp.status_code}: {msg}")
+        return data  # type: ignore[return-value]
+
+
+@mcp.tool()
+def screenshot(
+    url: str,
+    format: str = "png",
+    full_page: bool = False,
+    width: int = 1280,
+    height: int = 720,
+) -> dict[str, Any]:
+    """Capture a public URL as an image (PNG/JPEG/WebP). Returns JSON with image_base64 + receipt."""
+    body = {
+        "url": url,
+        "format": format,
+        "full_page": full_page,
+        "viewport": {"width": width, "height": height},
+    }
+    data = _post("/v1/screenshot", body)
+    if isinstance(data, dict) and data.get("image_base64"):
+        b64 = data["image_base64"]
+        data = {
+            **data,
+            "image_base64": b64,
+            "image_bytes_approx": len(base64.b64decode(b64)) if b64 else 0,
+        }
+    return data
+
+
+@mcp.tool()
+def pdf(url: str, print_background: bool = True, landscape: bool = False) -> dict[str, Any]:
+    """Capture a public URL as a PDF. Returns JSON with pdf_base64 + receipt."""
+    body = {
+        "url": url,
+        "print_background": print_background,
+        "landscape": landscape,
+    }
+    data = _post("/v1/pdf", body)
+    if isinstance(data, dict) and data.get("pdf_base64"):
+        b64 = data["pdf_base64"]
+        data = {
+            **data,
+            "pdf_base64": b64,
+            "pdf_bytes_approx": len(base64.b64decode(b64)) if b64 else 0,
+        }
+    return data
+
+
+@mcp.tool()
+def extract(
+    url: str,
+    include_links: bool = True,
+    max_text_chars: int = 20000,
+) -> dict[str, Any]:
+    """Extract title, meta description, canonical, main text, and links from a URL (non-LLM)."""
+    body = {
+        "url": url,
+        "include_links": include_links,
+        "max_text_chars": max_text_chars,
+    }
+    return _post("/v1/extract", body)
+
+
+def main() -> None:
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

agentrender_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,110 @@
+Metadata-Version: 2.5
+Name: agentrender-mcp
+Version: 0.1.0
+Summary: MCP helper: URL to screenshot, PDF, or structured extract for AI agents
+Project-URL: Homepage, https://agentrenderapi.com
+Project-URL: API, https://api.agentrenderapi.com
+Author: AgentRender
+License: MIT
+License-File: LICENSE
+Keywords: ai-agents,browser,extract,mcp,pdf,screenshot
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<3,>=1.9
+Description-Content-Type: text/markdown
+
+# AgentRender MCP
+
+**URL → screenshot, PDF, or structured extract for AI agents** via [MCP](https://modelcontextprotocol.io) (stdio) + REST.
+
+- Site: https://agentrenderapi.com  
+- API: https://api.agentrenderapi.com  
+
+Tools: `screenshot` · `pdf` · `extract`
+
+## Install
+
+```bash
+pip install agentrender-mcp
+# or from this repo:
+pip install .
+```
+
+Requires an AgentRender API key (`akr_…`) from https://agentrenderapi.com (free waitlist path or paid Starter $17 / Growth $79 / Scale $259).
+
+## Environment
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `AGENTRENDER_API_KEY` | _(required)_ | Bearer API key |
+| `AGENTRENDER_BASE_URL` | `https://api.agentrenderapi.com` | API base |
+
+## Run (stdio)
+
+```bash
+export AGENTRENDER_API_KEY=akr_your_key
+agentrender-mcp
+# or: python -m agentrender_mcp.server
+```
+
+## Cursor / Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "agentrender": {
+      "command": "agentrender-mcp",
+      "env": {
+        "AGENTRENDER_API_KEY": "akr_your_key",
+        "AGENTRENDER_BASE_URL": "https://api.agentrenderapi.com"
+      }
+    }
+  }
+}
+```
+
+If `agentrender-mcp` is not on `PATH`, use your Python:
+
+```json
+{
+  "mcpServers": {
+    "agentrender": {
+      "command": "python",
+      "args": ["-m", "agentrender_mcp.server"],
+      "env": {
+        "AGENTRENDER_API_KEY": "akr_your_key"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Maps to | Notes |
+|------|---------|--------|
+| `screenshot` | `POST /v1/screenshot` | PNG/JPEG/WebP; returns `image_base64` + receipt |
+| `pdf` | `POST /v1/pdf` | Returns `pdf_base64` + receipt |
+| `extract` | `POST /v1/extract` | Title, meta, canonical, text, links (non-LLM) |
+
+## REST smoke
+
+```bash
+curl -s https://api.agentrenderapi.com/health
+curl -s -X POST https://api.agentrenderapi.com/v1/extract \
+  -H "Authorization: Bearer $AGENTRENDER_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"url":"https://example.com"}'
+```
+
+## Notes
+
+- Hosted Streamable HTTP MCP is not shipped in this package yet; use stdio as above.
+- Do not commit API keys. Rotate any key that leaks.
+- Support: hello@ via product site / waitlist flow.
+
+## License
+
+MIT
+
+<!-- mcp-name: io.github.corbinvachal48/agentrender-mcp -->

agentrender_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+agentrender_mcp/__init__.py,sha256=N0XtFvKhbwXr58EGctsRVqJWJHKaRez1WfCt556F0zg,88
+agentrender_mcp/server.py,sha256=q0dBzBuYcS2D9A9YfHfEzGyINgr4NmG2qMx9XEmYCtY,4061
+agentrender_mcp-0.1.0.dist-info/METADATA,sha256=bqkbAjaRjyEmo2LsmssWoxDL0kRNsU81cIQPqLyBjAM,2677
+agentrender_mcp-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+agentrender_mcp-0.1.0.dist-info/entry_points.txt,sha256=_O01KiW4tVJcFroPRqFl8YAoPWVBoAU1lCL7cxIUaaY,64
+agentrender_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=nT4MQjWFyksjSFFit2CnV7ptW6-Pj3JmfkwdAOhtii0,1068
+agentrender_mcp-0.1.0.dist-info/RECORD,,

agentrender_mcp-0.1.0.dist-info/WHEEL

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

agentrender_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agentrender-mcp = agentrender_mcp.server:main

agentrender_mcp-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentRender
+
+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.