kiprio MCP Server

July 30, 2026 · View on GitHub

PyPI Downloads Python License MCP Compatible Stars Glama

27 production API tools for Claude Code, Claude Desktop, Cursor, Cline, Continue, and any MCP 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.


Quick install

No install needed — run it straight from PyPI with uv:

uvx kiprio-mcp

Or install with pip:

pip install kiprio-mcp

Claude Code — add to your project in one step:

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:

{
  "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:

{
  "mcpServers": {
    "kiprio": {
      "command": "uvx",
      "args": ["kiprio-mcp"],
      "env": {"KIPRIO_API_KEY": "your_key_here"}
    }
  }
}

Continue.dev — add to ~/.continue/config.json under mcpServers:

{
  "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 — 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):

# 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

ToolWhat it does
validate_emailSyntax + MX record check + disposable domain detection
validate_phoneInternational phone number validation, E.164 format + country info
validate_vatEU VAT number validation via VIES, returns company name
validate_ibanIBAN validation + bank details
check_password_breachk-anonymity breach check — only a 5-char SHA1 prefix is sent

Location & Time

ToolWhat it does
geocode_addressConvert address or place name → lat/lon + structured address components
get_timezoneCity → IANA timezone, UTC offset, current local time, DST details
convert_timezoneConvert a datetime between any two IANA timezones (no key required)

Network & DNS

ToolWhat it does
dns_lookupQuery A, AAAA, MX, TXT, NS, CNAME, SOA records
whois_lookupDomain registrar, creation/expiry dates, nameservers
ssl_checkCertificate validity, expiry, issuer, SANs
ip_lookupGeolocation + VPN/Tor/datacenter detection with threat score

Web & Content

ToolWhat it does
readabilityExtract main article text and metadata from any URL
tech_stackDetect CMS, framework, CDN, analytics, payments
parse_og_tagsOpen Graph, Twitter Card, and meta tags from a URL
screenshot_urlFull-page or viewport screenshot → base64 PNG
html_to_pdfConvert HTML to PDF → base64 bytes

Text Processing

ToolWhat it does
sentiment_analysispositive/negative/neutral label + compound score (−1 to 1)
check_grammarRewrite for grammar/spelling + diff of edits; styles: concise, formal, friendly, UK-en, US-en
translate_textTranslate between languages with auto source detection
summarize_textExtract key points (configurable sentence count)
redact_textReplace PII with [REDACTED_TYPE] placeholders

Developer Utilities

ToolWhat it does
generate_qrQR code → base64 PNG or SVG; custom colours and size
generate_hashHash string with sha256, sha512, sha1, md5, sha3_256, or blake2b
generate_uuidGenerate UUID v1, v4, or v7
parse_cronParse a cron expression → next 5 run times + human description
decode_jwtDecode JWT header + payload + expiry status (no verification)

Rate limits

TierLimitCost
Anonymous (no key)50–100 req/day/tool$0
Free key100 req/day/tool$0sign up
Pro1,000 req/day/tool$9/mo
Business10,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 →

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 →


Claude Code setup

claude mcp add kiprio -- uvx kiprio-mcp
claude mcp list   # should show kiprio

Or with a pip install:

pip install kiprio-mcp
claude mcp add kiprio -- kiprio-mcp

With API key in your project .env:

echo "KIPRIO_API_KEY=your_key" >> .env

Then reference in your MCP config:

{
  "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:

"command": "/path/to/venv/bin/kiprio-mcp"

429 Rate limit exceeded — free anonymous tier hit. Register at kiprio.com/signup for 100 req/day free, or upgrade to Pro 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 — MIT licence.

Maintained by ForeverTools. APIs powered by kiprio.com.