regintel-mcp 0.1.0__tar.gz

regintel_mcp-0.1.0/.gitignore

@@ -0,0 +1,49 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+.buildvenv/
+venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Secrets
+.env
+.env.local
+.pypirc
+
+# Test
+.pytest_cache/
+.coverage
+htmlcov/

regintel_mcp-0.1.0/LICENSE

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

regintel_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: regintel-mcp
+Version: 0.1.0
+Summary: MCP server for the RegIntel API — structured regulatory data across 41 jurisdictions and 212 regulations
+Project-URL: Homepage, https://regintelapi.com/
+Project-URL: Documentation, https://regintelapi.com/docs.html
+Project-URL: Repository, https://github.com/ad0750/regintel-mcp
+Project-URL: Issues, https://github.com/ad0750/regintel-mcp/issues
+Author-email: RegIntel <support@regintelapi.com>
+License: MIT
+License-File: LICENSE
+Keywords: aml,compliance,fintech,gdpr,kyc,mcp,model-context-protocol,regtech,regulatory
+Classifier: Development Status :: 4 - Beta
+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.27.0
+Requires-Dist: mcp[cli]>=1.2.0
+Description-Content-Type: text/markdown
+
+# regintel-mcp
+
+MCP server for the [RegIntel API](https://regintelapi.com/) — structured regulatory data across 41 jurisdictions and 212 regulations, accessible to any MCP-compatible LLM client (Claude Desktop, Claude Code, etc.).
+
+## Tools
+
+| Tool | Description |
+| --- | --- |
+| `list_jurisdictions` | All 41 supported jurisdictions with codes and regulation counts. Does not consume credits. |
+| `search_regulations` | Filter the catalog by jurisdiction, tag, keyword, category. Paginated. |
+| `get_regulation` | Full record (obligations, penalties, scope, source URL) for one regulation by ID. |
+| `get_recent_updates` | Regulations added or modified since a date. Useful for keeping vector stores in sync. |
+| `check_compliance` | Decision signal (allowed / requires_license / restricted / prohibited) for an activity in a country. |
+
+## Install
+
+```bash
+pip install regintel-mcp
+```
+
+## Get an API key
+
+Free tier includes 100 credits with no expiry and no credit card: https://regintelapi.com/get-key.html
+
+## Configure with Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "regintel": {
+      "command": "regintel-mcp",
+      "env": {
+        "REGINTEL_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The five tools above should appear under the regintel server.
+
+## Configure with Claude Code
+
+```bash
+claude mcp add regintel -e REGINTEL_API_KEY=your-api-key-here -- regintel-mcp
+```
+
+## Environment variables
+
+- `REGINTEL_API_KEY` *(required)* — your API key. Without it, every tool call returns an actionable error message.
+- `REGINTEL_API_BASE` *(optional)* — override the API base URL. Defaults to `https://api.regintelapi.com`.
+
+## License
+
+MIT

regintel_mcp-0.1.0/README.md

@@ -0,0 +1,57 @@
+# regintel-mcp
+
+MCP server for the [RegIntel API](https://regintelapi.com/) — structured regulatory data across 41 jurisdictions and 212 regulations, accessible to any MCP-compatible LLM client (Claude Desktop, Claude Code, etc.).
+
+## Tools
+
+| Tool | Description |
+| --- | --- |
+| `list_jurisdictions` | All 41 supported jurisdictions with codes and regulation counts. Does not consume credits. |
+| `search_regulations` | Filter the catalog by jurisdiction, tag, keyword, category. Paginated. |
+| `get_regulation` | Full record (obligations, penalties, scope, source URL) for one regulation by ID. |
+| `get_recent_updates` | Regulations added or modified since a date. Useful for keeping vector stores in sync. |
+| `check_compliance` | Decision signal (allowed / requires_license / restricted / prohibited) for an activity in a country. |
+
+## Install
+
+```bash
+pip install regintel-mcp
+```
+
+## Get an API key
+
+Free tier includes 100 credits with no expiry and no credit card: https://regintelapi.com/get-key.html
+
+## Configure with Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "regintel": {
+      "command": "regintel-mcp",
+      "env": {
+        "REGINTEL_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The five tools above should appear under the regintel server.
+
+## Configure with Claude Code
+
+```bash
+claude mcp add regintel -e REGINTEL_API_KEY=your-api-key-here -- regintel-mcp
+```
+
+## Environment variables
+
+- `REGINTEL_API_KEY` *(required)* — your API key. Without it, every tool call returns an actionable error message.
+- `REGINTEL_API_BASE` *(optional)* — override the API base URL. Defaults to `https://api.regintelapi.com`.
+
+## License
+
+MIT

regintel_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "regintel-mcp"
+version = "0.1.0"
+description = "MCP server for the RegIntel API — structured regulatory data across 41 jurisdictions and 212 regulations"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "RegIntel", email = "support@regintelapi.com" }]
+keywords = ["mcp", "model-context-protocol", "regulatory", "compliance", "regtech", "fintech", "gdpr", "kyc", "aml"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "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[cli]>=1.2.0",
+  "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://regintelapi.com/"
+Documentation = "https://regintelapi.com/docs.html"
+Repository = "https://github.com/ad0750/regintel-mcp"
+Issues = "https://github.com/ad0750/regintel-mcp/issues"
+
+[project.scripts]
+regintel-mcp = "regintel_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/regintel_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/README.md",
+  "/LICENSE",
+  "/pyproject.toml",
+]

regintel_mcp-0.1.0/src/regintel_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""MCP server for the RegIntel API."""
+
+__version__ = "0.1.0"

regintel_mcp-0.1.0/src/regintel_mcp/server.py

@@ -0,0 +1,175 @@
+"""RegIntel MCP server — exposes the RegIntel REST API as MCP tools."""
+
+from __future__ import annotations
+
+import os
+import sys
+from typing import Any
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+API_BASE = os.environ.get("REGINTEL_API_BASE", "https://api.regintelapi.com")
+API_KEY = os.environ.get("REGINTEL_API_KEY", "")
+USER_AGENT = "regintel-mcp/0.1.0"
+TIMEOUT_SECONDS = 30.0
+
+mcp = FastMCP("regintel")
+
+
+async def _request(path: str, params: dict[str, Any] | None = None) -> str:
+    """GET helper that returns a string ready to hand back to the LLM.
+
+    Errors are returned as plain-text messages rather than raised so the LLM
+    sees an actionable explanation instead of a stack trace.
+    """
+    if not API_KEY:
+        return (
+            "Error: REGINTEL_API_KEY environment variable is not set. "
+            "Get a free API key at https://regintelapi.com/get-key.html and set "
+            "REGINTEL_API_KEY in your MCP client configuration."
+        )
+
+    url = f"{API_BASE}{path}"
+    headers = {"x-api-key": API_KEY, "User-Agent": USER_AGENT, "Accept": "application/json"}
+    cleaned = {k: v for k, v in (params or {}).items() if v is not None and v != ""}
+
+    try:
+        async with httpx.AsyncClient(timeout=TIMEOUT_SECONDS) as client:
+            response = await client.get(url, headers=headers, params=cleaned)
+    except httpx.TimeoutException:
+        return f"Error: request to {path} timed out after {TIMEOUT_SECONDS}s."
+    except httpx.HTTPError as exc:
+        return f"Error: network failure calling {path}: {exc}"
+
+    if response.status_code == 200:
+        return response.text
+
+    try:
+        body = response.json()
+        message = body.get("message") or body.get("error") or response.text
+    except Exception:
+        message = response.text
+
+    if response.status_code == 401:
+        return f"Error 401 (unauthorized): {message}. Check that REGINTEL_API_KEY is correct."
+    if response.status_code == 403:
+        return (
+            f"Error 403 (forbidden): {message}. You may be out of credits — "
+            "check https://regintelapi.com/dashboard.html or top up at /pricing.html."
+        )
+    if response.status_code == 404:
+        return f"Error 404 (not found): {message}"
+    if response.status_code == 429:
+        retry_after = response.headers.get("Retry-After", "unknown")
+        return f"Error 429 (rate limited): retry after {retry_after}s."
+    return f"Error {response.status_code}: {message}"
+
+
+@mcp.tool()
+async def list_jurisdictions() -> str:
+    """List all regulatory jurisdictions supported by RegIntel, with their codes and regulation counts.
+
+    Use this to discover the universe of supported regions (currently 41) and the canonical
+    jurisdiction codes you can pass to other tools like search_regulations or check_compliance.
+    This endpoint does not consume API credits.
+    """
+    return await _request("/jurisdictions")
+
+
+@mcp.tool()
+async def search_regulations(
+    jurisdiction: str | None = None,
+    tag: str | None = None,
+    q: str | None = None,
+    category: str | None = None,
+    limit: int | None = None,
+    page: int | None = None,
+) -> str:
+    """Search the regulation catalog. Returns a paginated list of regulations matching the filters.
+
+    Each result includes title, jurisdiction, category, tags, and a summary. To get the full
+    obligations/penalties/scope for a specific regulation, follow up with get_regulation(id).
+
+    Args:
+        jurisdiction: ISO-style jurisdiction code, e.g. "EU", "US", "AU", "SG", "UK". Optional.
+        tag: Tag filter, e.g. "GDPR", "KYC", "AML", "crypto". Optional.
+        q: Free-text keyword search across regulation title and body. Optional.
+        category: Category filter (e.g. "data_protection", "payments"). Optional.
+        limit: Number of results per page. Optional.
+        page: Page number for pagination. Optional.
+    """
+    params = {
+        "jurisdiction": jurisdiction,
+        "tag": tag,
+        "q": q,
+        "category": category,
+        "limit": limit,
+        "page": page,
+    }
+    return await _request("/regulations", params=params)
+
+
+@mcp.tool()
+async def get_regulation(regulation_id: str) -> str:
+    """Get the full record for a single regulation by its unique ID.
+
+    Returns the complete regulation document: title, jurisdiction, obligations, penalties,
+    scope, tags, source URL, key articles, and timestamps. Use search_regulations first to
+    discover IDs.
+
+    Args:
+        regulation_id: Regulation ID, e.g. "gdpr-2018". Required.
+    """
+    if not regulation_id:
+        return "Error: regulation_id is required."
+    return await _request(f"/regulations/{regulation_id}")
+
+
+@mcp.tool()
+async def get_recent_updates(
+    since: str | None = None,
+    jurisdiction: str | None = None,
+) -> str:
+    """List regulations added or modified recently. Use this to keep a downstream cache or
+    vector store in sync — only re-process what changed.
+
+    Args:
+        since: ISO date (YYYY-MM-DD) lower bound for the modification timestamp, e.g. "2026-01-01".
+            If omitted, the API returns the default recent window.
+        jurisdiction: Optional jurisdiction code to scope the query, e.g. "EU".
+    """
+    return await _request("/updates", params={"since": since, "jurisdiction": jurisdiction})
+
+
+@mcp.tool()
+async def check_compliance(country: str, activity: str) -> str:
+    """Check the regulatory status of an activity in a country. Returns a decision signal —
+    one of `allowed`, `requires_license`, `restricted`, `prohibited`, or `unknown` — along
+    with risk level, penalties, obligations, and the source regulations behind the decision.
+
+    NOT LEGAL ADVICE. This endpoint provides regulatory intelligence derived from structured
+    data; always consult a qualified legal professional before acting on it.
+
+    Args:
+        country: Country code or name, e.g. "AU", "US", "EU", "SG", "UK". Required.
+        activity: One of "crypto", "finance", "banking", "payments", "lending", "privacy",
+            "data_protection", "aml", "kyc". Required.
+    """
+    if not country or not activity:
+        return "Error: both 'country' and 'activity' are required."
+    return await _request("/compliance-check", params={"country": country, "activity": activity})
+
+
+def main() -> None:
+    print(f"regintel-mcp starting (API base: {API_BASE})", file=sys.stderr)
+    if not API_KEY:
+        print(
+            "Warning: REGINTEL_API_KEY is not set; tool calls will return an error until it is.",
+            file=sys.stderr,
+        )
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()