# kiprio MCP Server [](https://pypi.org/project/kiprio-mcp/) [](https://pypi.org/project/kiprio-mcp/) [](https://pypi.org/project/kiprio-mcp/) [](LICENSE) [](https://modelcontextprotocol.io) [](https://github.com/ForeverTools/kiprio-mcp) [](https://glama.ai/mcp/servers/ForeverTools/kiprio-mcp) **27 production API tools for Claude Code, Claude Desktop, Cursor, Cline, Continue, and any [MCP](https://modelcontextprotocol.io) client** — email/phone validation, geocoding, timezone conversion, DNS/WHOIS, SSL inspection, web scraping, NLP, and developer utilities. No third-party API keys required. Free tier included. Powered by [kiprio.com](https://kiprio.com). --- ## Quick install No install needed — run it straight from PyPI with [uv](https://docs.astral.sh/uv/): ```bash uvx kiprio-mcp ``` Or install with pip: ```bash pip install kiprio-mcp ``` **Claude Code** — add to your project in one step: ```bash claude mcp add kiprio -- uvx kiprio-mcp # or, if installed via pip: claude mcp add kiprio -- kiprio-mcp ``` Or add to `~/.claude.json` / Claude Desktop / Cursor / Windsurf / Zed: ```json { "mcpServers": { "kiprio": { "command": "uvx", "args": ["kiprio-mcp"], "env": {"KIPRIO_API_KEY": "your_key_here"} } } } ``` (If you installed via pip instead, use `"command": "kiprio-mcp"` with no `args`.) **Cline (VS Code)** — open Cline → MCP Servers → Add Server → paste: ```json { "mcpServers": { "kiprio": { "command": "uvx", "args": ["kiprio-mcp"], "env": {"KIPRIO_API_KEY": "your_key_here"} } } } ``` **Continue.dev** — add to `~/.continue/config.json` under `mcpServers`: ```json { "mcpServers": [ { "name": "kiprio", "command": "uvx", "args": ["kiprio-mcp"], "env": {"KIPRIO_API_KEY": "your_key_here"} } ] } ``` ### Get your free API key (takes 30 seconds) The anonymous tier is rate-limited to **50–100 requests/day per tool** — fine for one-off queries, but it runs out fast in any automated workflow. **A free registered key gives you 100 req/day per tool at zero cost:** 👉 **[kiprio.com/signup](https://kiprio.com/signup?ref=kiprio-mcp)** — no credit card, no trial period. --- ## What you can do Once connected, ask Claude naturally: > *"Is noreply@company.io a real deliverable address?"* > → `validate_email` checks syntax, MX records, and disposable domain lists > *"What tech stack is stripe.com running?"* > → `tech_stack` returns CMS, CDN, analytics, and payment providers > *"Take a screenshot of this landing page and flag any broken layout."* > → `screenshot_url` returns a base64 PNG Claude can analyse directly > *"Redact all PII from this support transcript before I send it to Zendesk."* > → `redact_text` replaces emails, phones, names, and card numbers with `[REDACTED_TYPE]` > *"Check the SSL certificate on api.example.com — is it expiring soon?"* > → `ssl_check` returns expiry date, issuer, and grade --- ## Building an automated agent? kiprio tools are designed for pipelines and hooks, not just one-shot queries. Common patterns: **Email validation before accepting signups:** ``` User submits email → Claude: validate_email("user@example.com") → If disposable/invalid → reject early, before DB write ``` **Domain monitoring hook (Claude Code slash command):** ```bash # Add to CLAUDE.md as a custom slash command /check-ssl → ssl_check on all domains in config/domains.txt ``` **Lead enrichment agent:** ``` CSV of company domains → Claude loops: tech_stack() + whois_lookup() + ip_lookup() per row → Output: enriched CSV with stack, registrar, country, hosting provider ``` **Content moderation pipeline:** ``` User-submitted text → sentiment_analysis() to flag negative → redact_text() to strip PII before logging ``` These patterns work within the free key tier (100 req/day per tool). Pro tier (1,000/day) handles larger batches. --- ## Tools ### Email & Validation | Tool | What it does | |------|-------------| | `validate_email` | Syntax + MX record check + disposable domain detection | | `validate_phone` | International phone number validation, E.164 format + country info | | `validate_vat` | EU VAT number validation via VIES, returns company name | | `validate_iban` | IBAN validation + bank details | | `check_password_breach` | k-anonymity breach check — only a 5-char SHA1 prefix is sent | ### Location & Time | Tool | What it does | |------|-------------| | `geocode_address` | Convert address or place name → lat/lon + structured address components | | `get_timezone` | City → IANA timezone, UTC offset, current local time, DST details | | `convert_timezone` | Convert a datetime between any two IANA timezones (no key required) | ### Network & DNS | Tool | What it does | |------|-------------| | `dns_lookup` | Query A, AAAA, MX, TXT, NS, CNAME, SOA records | | `whois_lookup` | Domain registrar, creation/expiry dates, nameservers | | `ssl_check` | Certificate validity, expiry, issuer, SANs | | `ip_lookup` | Geolocation + VPN/Tor/datacenter detection with threat score | ### Web & Content | Tool | What it does | |------|-------------| | `readability` | Extract main article text and metadata from any URL | | `tech_stack` | Detect CMS, framework, CDN, analytics, payments | | `parse_og_tags` | Open Graph, Twitter Card, and meta tags from a URL | | `screenshot_url` | Full-page or viewport screenshot → base64 PNG | | `html_to_pdf` | Convert HTML to PDF → base64 bytes | ### Text Processing | Tool | What it does | |------|-------------| | `sentiment_analysis` | positive/negative/neutral label + compound score (−1 to 1) | | `check_grammar` | Rewrite for grammar/spelling + diff of edits; styles: concise, formal, friendly, UK-en, US-en | | `translate_text` | Translate between languages with auto source detection | | `summarize_text` | Extract key points (configurable sentence count) | | `redact_text` | Replace PII with `[REDACTED_TYPE]` placeholders | ### Developer Utilities | Tool | What it does | |------|-------------| | `generate_qr` | QR code → base64 PNG or SVG; custom colours and size | | `generate_hash` | Hash string with sha256, sha512, sha1, md5, sha3_256, or blake2b | | `generate_uuid` | Generate UUID v1, v4, or v7 | | `parse_cron` | Parse a cron expression → next 5 run times + human description | | `decode_jwt` | Decode JWT header + payload + expiry status (no verification) | --- ## Rate limits | Tier | Limit | Cost | |------|-------|------| | Anonymous (no key) | **50–100 req/day/tool** | $0 | | **Free key** | **100 req/day/tool** | **$0** — [sign up](https://kiprio.com/signup?ref=kiprio-mcp) | | **Pro** | **1,000 req/day/tool** | **$9/mo** | | Business | 10,000 req/day/tool | $39/mo | **Free key vs anonymous:** Same tools, 3× the headroom, still $0. Just needs an email address. [Get your free key at kiprio.com/signup →](https://kiprio.com/signup?ref=kiprio-mcp) ### When to upgrade to Pro - **Batch processing** — validating 500 emails, enriching a CSV, running a link audit - **Scheduled agents** — Claude Code hooks that fire on every commit or cron job - **Team workspaces** — multiple developers sharing one config - **Production scripts** — slash commands that run on every file save or PR [Upgrade to Pro at kiprio.com →](https://kiprio.com/products/mcp-server/) --- ## Claude Code setup ```bash claude mcp add kiprio -- uvx kiprio-mcp claude mcp list # should show kiprio ``` Or with a pip install: ```bash pip install kiprio-mcp claude mcp add kiprio -- kiprio-mcp ``` With API key in your project `.env`: ```bash echo "KIPRIO_API_KEY=your_key" >> .env ``` Then reference in your MCP config: ```json { "mcpServers": { "kiprio": { "command": "uvx", "args": ["kiprio-mcp"], "env": {"KIPRIO_API_KEY": "${KIPRIO_API_KEY}"} } } } ``` --- ## Troubleshooting **`kiprio-mcp: command not found` / `spawn kiprio-mcp ENOENT`** — the bare `kiprio-mcp` command only exists after a pip install. Either switch your config to `"command": "uvx", "args": ["kiprio-mcp"]` (no install needed), or point at the full path from your virtualenv: ```json "command": "/path/to/venv/bin/kiprio-mcp" ``` **`429 Rate limit exceeded`** — free anonymous tier hit. Register at [kiprio.com/signup](https://kiprio.com/signup?ref=kiprio-mcp) for 100 req/day free, or [upgrade to Pro](https://kiprio.com/products/mcp-server/) for 1,000/day. **`401/403 errors`** — API key invalid. Leave `KIPRIO_API_KEY` empty to use the anonymous tier (30 req/day). --- ## Source [github.com/ForeverTools/kiprio-mcp](https://github.com/ForeverTools/kiprio-mcp) — MIT licence. Maintained by [ForeverTools](https://github.com/ForeverTools). APIs powered by [kiprio.com](https://kiprio.com).