kanibal-tools-mcp 0.1.0__tar.gz

kanibal_tools_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ALTA VISTA360, S.L.U.
+
+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.

kanibal_tools_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: kanibal-tools-mcp
+Version: 0.1.0
+Summary: MCP server with four local, read-only tools: French telemarketing consent, cost per kept meeting, GDPR offshore checklist, least-cost capable model.
+Author: ALTA VISTA360, S.L.U.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/kanibal-studio/kanibal-tools-mcp
+Project-URL: Issues, https://github.com/kanibal-studio/kanibal-tools-mcp/issues
+Project-URL: PyPI, https://pypi.org/project/kanibal-tools-mcp/
+Keywords: mcp,model-context-protocol,gdpr,rgpd,consent,lead-generation,llm,agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp<2,>=1.12
+Requires-Dist: demarchage-consent>=0.2.0
+Requires-Dist: cost-per-kept-meeting>=0.1.2
+Requires-Dist: rgpd-offshore-check>=0.1.2
+Requires-Dist: least-cost-capable>=0.1.2
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# kanibal-tools-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/kanibal-tools-mcp)](https://pypi.org/project/kanibal-tools-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/kanibal-tools-mcp)](https://pypi.org/project/kanibal-tools-mcp/)
+[![CI](https://github.com/kanibal-studio/kanibal-tools-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/kanibal-studio/kanibal-tools-mcp/actions/workflows/ci.yml)
+[![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/kanibal-studio/kanibal-tools-mcp/blob/main/LICENSE)
+
+An [MCP](https://modelcontextprotocol.io) server that gives AI assistants four local,
+read-only tools from Kanibal Studio (ALTA VISTA360, S.L.U.):
+
+| Tool | What it does |
+|---|---|
+| `check_telemarketing_consent` | France only: tells whether a consent to telephone canvassing is still valid under décret 2026-662. Fail-closed. |
+| `rank_lead_sources_by_kept_meeting` | Ranks B2B lead sources, from CSV text, on cost per kept qualified meeting instead of cost per lead. |
+| `gdpr_offshore_gap_report` | GDPR gap report for customer service outsourced outside the EU/EEA. Not legal advice. |
+| `select_least_cost_capable_model` | Picks the lowest declared cost rank among the capable, available and authorised models of a supplied catalogue. |
+
+Each tool computes from its arguments only: no network call, no file access, no state
+kept between calls. All four are marked read-only and closed-world for MCP clients. They
+wrap the published packages [demarchage-consent](https://github.com/kanibal-studio/demarchage-consent),
+[cost-per-kept-meeting](https://github.com/kanibal-studio/cost-per-kept-meeting),
+[rgpd-offshore-check](https://github.com/kanibal-studio/rgpd-offshore-check) and
+[least-cost-capable](https://github.com/kanibal-studio/least-cost-capable).
+
+## Use with Claude Code
+
+```sh
+claude mcp add kanibal-tools -- uvx kanibal-tools-mcp
+```
+
+## Use with Claude Desktop, Cursor or another MCP client
+
+Add this server to the client's MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "kanibal-tools": {
+      "command": "uvx",
+      "args": ["kanibal-tools-mcp"]
+    }
+  }
+}
+```
+
+Without `uv`, install it with `pip install kanibal-tools-mcp` and use `kanibal-tools-mcp` as
+the command. The server speaks MCP over stdio and needs Python 3.10 or newer.
+
+## Example requests
+
+- "Is a telemarketing consent collected on 2025-11-02 still valid today?"
+- "Here is my CSV of lead sources for October: rank them by cost per kept meeting."
+- "Prepare a GDPR gap report for our customer service in Tunisia: we have SCCs but no transfer impact assessment."
+- "From this model catalogue, which is the cheapest one that can do Python and debugging?"
+
+## Limits
+
+- The consent tool applies French rules only (décret 2026-662). It is a check, not legal advice.
+- The GDPR report is a checklist: a report without blocking gap is not a finding of compliance.
+- A low cost per kept meeting does not prove profitability.
+- The model selection uses only the facts in the catalogue you supply; it does not switch
+  models, call providers or guarantee savings.
+
+## Development
+
+```sh
+pip install -e ".[dev]"
+pytest
+```
+
+The tests call every tool through an in-memory MCP client session.
+
+## Project context and license
+
+Prepared by [Kanibal Studio](https://github.com/kanibal-studio), associated with
+ALTA VISTA360, S.L.U. Our public sites are [Altavista360](https://altavista360.com),
+[Altavista Conseil](https://altavista-conseil.com) and [K-Pulse](https://infos.kanibal-studio.com/).
+
+Licensed under the [MIT License](LICENSE).
+
+<!-- mcp-name: io.github.kanibal-studio/kanibal-tools-mcp -->

kanibal_tools_mcp-0.1.0/README.md

@@ -0,0 +1,81 @@
+# kanibal-tools-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/kanibal-tools-mcp)](https://pypi.org/project/kanibal-tools-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/kanibal-tools-mcp)](https://pypi.org/project/kanibal-tools-mcp/)
+[![CI](https://github.com/kanibal-studio/kanibal-tools-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/kanibal-studio/kanibal-tools-mcp/actions/workflows/ci.yml)
+[![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/kanibal-studio/kanibal-tools-mcp/blob/main/LICENSE)
+
+An [MCP](https://modelcontextprotocol.io) server that gives AI assistants four local,
+read-only tools from Kanibal Studio (ALTA VISTA360, S.L.U.):
+
+| Tool | What it does |
+|---|---|
+| `check_telemarketing_consent` | France only: tells whether a consent to telephone canvassing is still valid under décret 2026-662. Fail-closed. |
+| `rank_lead_sources_by_kept_meeting` | Ranks B2B lead sources, from CSV text, on cost per kept qualified meeting instead of cost per lead. |
+| `gdpr_offshore_gap_report` | GDPR gap report for customer service outsourced outside the EU/EEA. Not legal advice. |
+| `select_least_cost_capable_model` | Picks the lowest declared cost rank among the capable, available and authorised models of a supplied catalogue. |
+
+Each tool computes from its arguments only: no network call, no file access, no state
+kept between calls. All four are marked read-only and closed-world for MCP clients. They
+wrap the published packages [demarchage-consent](https://github.com/kanibal-studio/demarchage-consent),
+[cost-per-kept-meeting](https://github.com/kanibal-studio/cost-per-kept-meeting),
+[rgpd-offshore-check](https://github.com/kanibal-studio/rgpd-offshore-check) and
+[least-cost-capable](https://github.com/kanibal-studio/least-cost-capable).
+
+## Use with Claude Code
+
+```sh
+claude mcp add kanibal-tools -- uvx kanibal-tools-mcp
+```
+
+## Use with Claude Desktop, Cursor or another MCP client
+
+Add this server to the client's MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "kanibal-tools": {
+      "command": "uvx",
+      "args": ["kanibal-tools-mcp"]
+    }
+  }
+}
+```
+
+Without `uv`, install it with `pip install kanibal-tools-mcp` and use `kanibal-tools-mcp` as
+the command. The server speaks MCP over stdio and needs Python 3.10 or newer.
+
+## Example requests
+
+- "Is a telemarketing consent collected on 2025-11-02 still valid today?"
+- "Here is my CSV of lead sources for October: rank them by cost per kept meeting."
+- "Prepare a GDPR gap report for our customer service in Tunisia: we have SCCs but no transfer impact assessment."
+- "From this model catalogue, which is the cheapest one that can do Python and debugging?"
+
+## Limits
+
+- The consent tool applies French rules only (décret 2026-662). It is a check, not legal advice.
+- The GDPR report is a checklist: a report without blocking gap is not a finding of compliance.
+- A low cost per kept meeting does not prove profitability.
+- The model selection uses only the facts in the catalogue you supply; it does not switch
+  models, call providers or guarantee savings.
+
+## Development
+
+```sh
+pip install -e ".[dev]"
+pytest
+```
+
+The tests call every tool through an in-memory MCP client session.
+
+## Project context and license
+
+Prepared by [Kanibal Studio](https://github.com/kanibal-studio), associated with
+ALTA VISTA360, S.L.U. Our public sites are [Altavista360](https://altavista360.com),
+[Altavista Conseil](https://altavista-conseil.com) and [K-Pulse](https://infos.kanibal-studio.com/).
+
+Licensed under the [MIT License](LICENSE).
+
+<!-- mcp-name: io.github.kanibal-studio/kanibal-tools-mcp -->

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""kanibal-tools-mcp: MCP server for four local, read-only Kanibal Studio tools."""
+
+__version__ = "0.1.0"

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp/__main__.py

@@ -0,0 +1,3 @@
+from .server import main
+
+main()

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp/server.py

@@ -0,0 +1,138 @@
+"""MCP server exposing four local, read-only Kanibal Studio tools.
+
+Every tool is a pure computation on the arguments it receives: no network call,
+no file read or write, no state kept between calls. The underlying packages are
+published separately on PyPI (demarchage-consent, cost-per-kept-meeting,
+rgpd-offshore-check, least-cost-capable).
+"""
+
+from __future__ import annotations
+
+import io
+import json
+from datetime import datetime
+from typing import Any, Optional
+
+import cost_per_kept_meeting as cpkm
+import demarchage_consent as consent
+import rgpd_offshore_check as rgpd
+from least_cost_capable.select_model import select
+from mcp.server.fastmcp import FastMCP
+from mcp.types import ToolAnnotations
+
+from . import __version__
+
+LOCAL_READ_ONLY = ToolAnnotations(
+    readOnlyHint=True,
+    destructiveHint=False,
+    idempotentHint=True,
+    openWorldHint=False,
+)
+
+mcp = FastMCP(
+    "kanibal-tools",
+    instructions=(
+        "Local, read-only tools from Kanibal Studio (ALTA VISTA360, S.L.U.). They compute "
+        "from the arguments only and never contact a service. The consent and GDPR tools "
+        "are checklists, not legal advice."
+    ),
+    website_url="https://github.com/kanibal-studio/kanibal-tools-mcp",
+)
+# FastMCP takes no version argument; without this the server reports the SDK version.
+mcp._mcp_server.version = __version__
+
+
+def _iso(value: Optional[datetime]) -> Optional[str]:
+    return value.isoformat() if value is not None else None
+
+
+@mcp.tool(annotations=LOCAL_READ_ONLY)
+def check_telemarketing_consent(
+    collected_at: str,
+    revoked_at: Optional[str] = None,
+    now: Optional[str] = None,
+    max_age_days: Optional[int] = None,
+) -> dict[str, Any]:
+    """France only: is a consent to telephone canvassing still valid under décret 2026-662?
+
+    Dates are ISO 8601 (a date without time zone is read as UTC). Statuses:
+    "valide", "expire" (older than the ceiling, 365 days at most), "revoque"
+    (any sign of revocation wins), "preuve_manquante" (no readable collection
+    date, or one in the future). Fail-closed. Not legal advice.
+    """
+    result = consent.assess_consent(
+        collected_at, now=now, revoked_at=revoked_at, max_age_days=max_age_days
+    )
+    return {
+        "status": str(result.status),
+        "evaluated_at": _iso(result.evaluated_at),
+        "collected_at": _iso(result.collected_at),
+        "revoked_at": _iso(result.revoked_at),
+        "max_age_days": result.max_age_days,
+        "expires_at": _iso(result.expires_at),
+        "proof_retention_until": _iso(result.proof_retention_until),
+        "days_remaining": result.days_remaining,
+        "decree": consent.DECREE_REFERENCE,
+        "tool": f"demarchage-consent {consent.__version__}",
+    }
+
+
+@mcp.tool(annotations=LOCAL_READ_ONLY)
+def rank_lead_sources_by_kept_meeting(
+    csv_text: str, min_meetings: int = cpkm.DEFAULT_MIN_MEETINGS
+) -> dict[str, Any]:
+    """Rank B2B lead sources on cost per kept qualified meeting instead of cost per lead.
+
+    csv_text is the CSV file content, with the columns documented at
+    https://github.com/kanibal-studio/cost-per-kept-meeting#input-columns.
+    Results under min_meetings qualified kept meetings are flagged as a small
+    sample, never hidden. A low cost per meeting does not prove profitability.
+    """
+    try:
+        table = cpkm.parse_csv(io.StringIO(csv_text))
+    except cpkm.InputError as exc:
+        raise ValueError("invalid CSV: " + "; ".join(exc.messages)) from exc
+    results = cpkm.analyse(table, min_meetings=min_meetings)
+    document = json.loads(cpkm.render_json(results, min_meetings))
+    document["tool"] = f"cost-per-kept-meeting {cpkm.__version__}"
+    return document
+
+
+@mcp.tool(annotations=LOCAL_READ_ONLY)
+def gdpr_offshore_gap_report(answers: dict[str, Any], lang: str = "en") -> dict[str, Any]:
+    """GDPR gap report for customer-service processing outsourced outside the EU/EEA.
+
+    answers follows https://github.com/kanibal-studio/rgpd-offshore-check#input-format.
+    Only a JSON true satisfies a check; anything else is reported as a gap or
+    "to_verify". lang is "en" or "fr". Not legal advice and not a certification:
+    a report without blocking gap is not a finding of compliance.
+    """
+    return rgpd.evaluate(answers, lang=lang).to_dict()
+
+
+@mcp.tool(annotations=LOCAL_READ_ONLY)
+def select_least_cost_capable_model(catalogue: dict[str, Any]) -> dict[str, Any]:
+    """Pick, from a supplied catalogue, the model with the lowest declared cost rank
+    among those that have every required capability and are available and authorised.
+
+    catalogue follows https://github.com/kanibal-studio/least-cost-capable (fields
+    required_capabilities and models). Unknown or non-comparable cost evidence stays
+    unresolved. Nothing is called, switched or launched; savings are not guaranteed.
+    """
+    return select(catalogue)
+
+
+def main() -> None:
+    """Run the server over stdio (the transport used by desktop MCP clients)."""
+    mcp.run()
+
+
+__all__ = [
+    "__version__",
+    "check_telemarketing_consent",
+    "gdpr_offshore_gap_report",
+    "main",
+    "mcp",
+    "rank_lead_sources_by_kept_meeting",
+    "select_least_cost_capable_model",
+]

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp.egg-info/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: kanibal-tools-mcp
+Version: 0.1.0
+Summary: MCP server with four local, read-only tools: French telemarketing consent, cost per kept meeting, GDPR offshore checklist, least-cost capable model.
+Author: ALTA VISTA360, S.L.U.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/kanibal-studio/kanibal-tools-mcp
+Project-URL: Issues, https://github.com/kanibal-studio/kanibal-tools-mcp/issues
+Project-URL: PyPI, https://pypi.org/project/kanibal-tools-mcp/
+Keywords: mcp,model-context-protocol,gdpr,rgpd,consent,lead-generation,llm,agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp<2,>=1.12
+Requires-Dist: demarchage-consent>=0.2.0
+Requires-Dist: cost-per-kept-meeting>=0.1.2
+Requires-Dist: rgpd-offshore-check>=0.1.2
+Requires-Dist: least-cost-capable>=0.1.2
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# kanibal-tools-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/kanibal-tools-mcp)](https://pypi.org/project/kanibal-tools-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/kanibal-tools-mcp)](https://pypi.org/project/kanibal-tools-mcp/)
+[![CI](https://github.com/kanibal-studio/kanibal-tools-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/kanibal-studio/kanibal-tools-mcp/actions/workflows/ci.yml)
+[![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/kanibal-studio/kanibal-tools-mcp/blob/main/LICENSE)
+
+An [MCP](https://modelcontextprotocol.io) server that gives AI assistants four local,
+read-only tools from Kanibal Studio (ALTA VISTA360, S.L.U.):
+
+| Tool | What it does |
+|---|---|
+| `check_telemarketing_consent` | France only: tells whether a consent to telephone canvassing is still valid under décret 2026-662. Fail-closed. |
+| `rank_lead_sources_by_kept_meeting` | Ranks B2B lead sources, from CSV text, on cost per kept qualified meeting instead of cost per lead. |
+| `gdpr_offshore_gap_report` | GDPR gap report for customer service outsourced outside the EU/EEA. Not legal advice. |
+| `select_least_cost_capable_model` | Picks the lowest declared cost rank among the capable, available and authorised models of a supplied catalogue. |
+
+Each tool computes from its arguments only: no network call, no file access, no state
+kept between calls. All four are marked read-only and closed-world for MCP clients. They
+wrap the published packages [demarchage-consent](https://github.com/kanibal-studio/demarchage-consent),
+[cost-per-kept-meeting](https://github.com/kanibal-studio/cost-per-kept-meeting),
+[rgpd-offshore-check](https://github.com/kanibal-studio/rgpd-offshore-check) and
+[least-cost-capable](https://github.com/kanibal-studio/least-cost-capable).
+
+## Use with Claude Code
+
+```sh
+claude mcp add kanibal-tools -- uvx kanibal-tools-mcp
+```
+
+## Use with Claude Desktop, Cursor or another MCP client
+
+Add this server to the client's MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "kanibal-tools": {
+      "command": "uvx",
+      "args": ["kanibal-tools-mcp"]
+    }
+  }
+}
+```
+
+Without `uv`, install it with `pip install kanibal-tools-mcp` and use `kanibal-tools-mcp` as
+the command. The server speaks MCP over stdio and needs Python 3.10 or newer.
+
+## Example requests
+
+- "Is a telemarketing consent collected on 2025-11-02 still valid today?"
+- "Here is my CSV of lead sources for October: rank them by cost per kept meeting."
+- "Prepare a GDPR gap report for our customer service in Tunisia: we have SCCs but no transfer impact assessment."
+- "From this model catalogue, which is the cheapest one that can do Python and debugging?"
+
+## Limits
+
+- The consent tool applies French rules only (décret 2026-662). It is a check, not legal advice.
+- The GDPR report is a checklist: a report without blocking gap is not a finding of compliance.
+- A low cost per kept meeting does not prove profitability.
+- The model selection uses only the facts in the catalogue you supply; it does not switch
+  models, call providers or guarantee savings.
+
+## Development
+
+```sh
+pip install -e ".[dev]"
+pytest
+```
+
+The tests call every tool through an in-memory MCP client session.
+
+## Project context and license
+
+Prepared by [Kanibal Studio](https://github.com/kanibal-studio), associated with
+ALTA VISTA360, S.L.U. Our public sites are [Altavista360](https://altavista360.com),
+[Altavista Conseil](https://altavista-conseil.com) and [K-Pulse](https://infos.kanibal-studio.com/).
+
+Licensed under the [MIT License](LICENSE).
+
+<!-- mcp-name: io.github.kanibal-studio/kanibal-tools-mcp -->

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+kanibal_tools_mcp/__init__.py
+kanibal_tools_mcp/__main__.py
+kanibal_tools_mcp/server.py
+kanibal_tools_mcp.egg-info/PKG-INFO
+kanibal_tools_mcp.egg-info/SOURCES.txt
+kanibal_tools_mcp.egg-info/dependency_links.txt
+kanibal_tools_mcp.egg-info/entry_points.txt
+kanibal_tools_mcp.egg-info/requires.txt
+kanibal_tools_mcp.egg-info/top_level.txt
+tests/test_server.py

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+kanibal-tools-mcp = kanibal_tools_mcp.server:main

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp.egg-info/requires.txt

@@ -0,0 +1,8 @@
+mcp<2,>=1.12
+demarchage-consent>=0.2.0
+cost-per-kept-meeting>=0.1.2
+rgpd-offshore-check>=0.1.2
+least-cost-capable>=0.1.2
+
+[dev]
+pytest>=8

kanibal_tools_mcp-0.1.0/kanibal_tools_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+kanibal_tools_mcp

kanibal_tools_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kanibal-tools-mcp"
+dynamic = ["version"]
+description = "MCP server with four local, read-only tools: French telemarketing consent, cost per kept meeting, GDPR offshore checklist, least-cost capable model."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "ALTA VISTA360, S.L.U." }]
+keywords = ["mcp", "model-context-protocol", "gdpr", "rgpd", "consent", "lead-generation", "llm", "agents"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Office/Business",
+]
+dependencies = [
+    "mcp>=1.12,<2",
+    "demarchage-consent>=0.2.0",
+    "cost-per-kept-meeting>=0.1.2",
+    "rgpd-offshore-check>=0.1.2",
+    "least-cost-capable>=0.1.2",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[project.scripts]
+kanibal-tools-mcp = "kanibal_tools_mcp.server:main"
+
+[project.urls]
+Homepage = "https://github.com/kanibal-studio/kanibal-tools-mcp"
+Issues = "https://github.com/kanibal-studio/kanibal-tools-mcp/issues"
+PyPI = "https://pypi.org/project/kanibal-tools-mcp/"
+
+[tool.setuptools]
+packages = ["kanibal_tools_mcp"]
+
+[tool.setuptools.dynamic]
+version = { attr = "kanibal_tools_mcp.__version__" }
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

kanibal_tools_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kanibal_tools_mcp-0.1.0/tests/test_server.py

@@ -0,0 +1,129 @@
+"""The four tools, called through a real MCP client session held in memory."""
+
+from __future__ import annotations
+
+import asyncio
+import json
+
+from mcp.shared.memory import create_connected_server_and_client_session
+
+from kanibal_tools_mcp import __version__
+from kanibal_tools_mcp.server import mcp
+
+CSV = """source,period,cost_media,cost_data,cost_tools,cost_human_time,cost_other,leads,meetings_booked,meetings_kept,meetings_qualified_kept,deals_closed,gross_margin
+Example Purchased Lists,2026-10,0,2400,300,1800,0,1500,60,33,9,1,2500
+Example Partner Referrals,2026-10,0,0,150,900,1650,60,24,21,15,4,11000
+"""
+
+COST = {"metric": "API input-token cost", "unit": "USD per million input tokens",
+        "workload": "same coding task mix", "window": "2026-10-01 to 2026-10-11",
+        "source": "synthetic example", "as_of": "2026-10-11"}
+CATALOGUE = {
+    "required_capabilities": ["python", "debugging"],
+    "models": [
+        {"id": "economy-text", "available": True, "authorized": True,
+         "capabilities": ["python"], "capabilities_complete": True,
+         "cost": {**COST, "relative_rank": 1}},
+        {"id": "standard-code", "available": True, "authorized": True,
+         "capabilities": ["python", "debugging"], "capabilities_complete": True,
+         "cost": {**COST, "relative_rank": 2}},
+    ],
+}
+
+
+def _call(name: str, arguments: dict) -> tuple[bool, object]:
+    async def run():
+        async with create_connected_server_and_client_session(mcp._mcp_server) as client:
+            result = await client.call_tool(name, arguments)
+            text = "".join(c.text for c in result.content if getattr(c, "type", "") == "text")
+            payload = result.structuredContent
+            if payload is None and not result.isError:
+                payload = json.loads(text)
+            return result.isError, (text if result.isError else payload)
+
+    return asyncio.run(run())
+
+
+def _unwrap(payload: object) -> dict:
+    # FastMCP wraps non-object structured output as {"result": ...}.
+    if isinstance(payload, dict) and set(payload) == {"result"}:
+        return payload["result"]
+    return payload
+
+
+def test_lists_exactly_four_read_only_local_tools():
+    async def run():
+        async with create_connected_server_and_client_session(mcp._mcp_server) as client:
+            return (await client.list_tools()).tools
+
+    tools = asyncio.run(run())
+    assert sorted(t.name for t in tools) == [
+        "check_telemarketing_consent",
+        "gdpr_offshore_gap_report",
+        "rank_lead_sources_by_kept_meeting",
+        "select_least_cost_capable_model",
+    ]
+    for tool in tools:
+        assert tool.annotations.readOnlyHint is True
+        assert tool.annotations.openWorldHint is False
+        assert tool.annotations.destructiveHint is False
+        assert tool.description and len(tool.description) > 40
+
+
+def test_consent_statuses_are_fail_closed():
+    error, valid = _call(
+        "check_telemarketing_consent",
+        {"collected_at": "2026-03-01", "now": "2026-10-01"},
+    )
+    assert not error and _unwrap(valid)["status"] == "valide"
+    assert _unwrap(valid)["days_remaining"] > 0
+
+    _, expired = _call(
+        "check_telemarketing_consent",
+        {"collected_at": "2025-01-01", "now": "2026-10-01"},
+    )
+    assert _unwrap(expired)["status"] == "expire"
+
+    _, missing = _call("check_telemarketing_consent", {"collected_at": "not a date"})
+    assert _unwrap(missing)["status"] == "preuve_manquante"
+
+    _, revoked = _call(
+        "check_telemarketing_consent",
+        {"collected_at": "2026-09-01", "revoked_at": "oui", "now": "2026-10-01"},
+    )
+    assert _unwrap(revoked)["status"] == "revoque"
+
+
+def test_ranking_puts_referrals_before_purchased_lists():
+    error, payload = _call("rank_lead_sources_by_kept_meeting", {"csv_text": CSV})
+    assert not error
+    results = _unwrap(payload)["results"]
+    assert [r["source"] for r in results][0] == "Example Partner Referrals"
+
+
+def test_invalid_csv_is_a_named_tool_error_not_a_crash():
+    error, text = _call("rank_lead_sources_by_kept_meeting", {"csv_text": "a,b\n1,2\n"})
+    assert error and "invalid CSV" in text
+
+
+def test_gdpr_report_keeps_disclaimer_and_flags_unanswered_items():
+    error, payload = _call(
+        "gdpr_offshore_gap_report",
+        {"answers": {"destination_country": "Tunisia"}, "lang": "fr"},
+    )
+    report = _unwrap(payload)
+    assert not error and report["lang"] == "fr"
+    assert report["disclaimer"]
+    # Unanswered items are "to_verify", never compliant, and still block (fail-closed).
+    assert report["summary"]["result"] == "blocking_gap"
+    assert len(report["summary"]["blocking_to_verify"]) > 0
+
+
+def test_model_selection_uses_the_capability_filter():
+    error, payload = _call("select_least_cost_capable_model", {"catalogue": CATALOGUE})
+    assert not error and _unwrap(payload)["selected"] == "standard-code"
+
+
+def test_version_is_exposed_to_clients():
+    assert __version__ == "0.1.0"
+    assert mcp._mcp_server.version == __version__