clevertech-mcp-server 0.3.2__tar.gz → 0.3.4__tar.gz

{clevertech_mcp_server-0.3.2 → clevertech_mcp_server-0.3.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: clevertech-mcp-server
-Version: 0.3.2
-Summary: MCP Server for CleverTech Canadian government data APIs
+Version: 0.3.4
+Summary: CleverTech MCP server — Canadian government data for AI agents: property, permits, zoning, business registry, and GPS ↔ DLS conversion. Free tier available.
 Author-email: CleverTech <dev@clevertech.ca>
 License: MIT
 License-File: LICENSE
@@ -22,15 +22,14 @@ Description-Content-Type: text/markdown
 
 # CleverTech MCP Server
 
-<!-- mcp-name: ca.clevertech/clevertech-mcp-server -->
-
-**Canadian government data for AI agents.** Property assessments, building permits, zoning, business registry, DLS grid conversion — 50 free queries/day, no signup.
+**CleverTech MCP server for AI agents.** Canadian government data — property assessments, building permits, zoning, business registry, and GPS ↔ DLS conversion. Free tier available, no signup.
 
 ```bash
-uvx clevertech-mcp-server
+npx @clevertech/mcp-server
 ```
 
 [![PyPI version](https://badge.fury.io/py/clevertech-mcp-server.svg)](https://pypi.org/project/clevertech-mcp-server/)
+[![npm version](https://badge.fury.io/npm/%40clevertech%2Fmcp-server.svg)](https://www.npmjs.com/package/@clevertech/mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 ---
@@ -45,8 +44,8 @@ Add to your `~/.claude/claude_desktop_config.json`:
 {
   "mcpServers": {
     "clevertech": {
-      "command": "uvx",
-      "args": ["clevertech-mcp-server"]
+      "command": "npx",
+      "args": ["-y", "@clevertech/mcp-server"]
     }
   }
 }
@@ -73,8 +72,8 @@ Add to your MCP configuration:
 {
   "mcpServers": {
     "clevertech": {
-      "command": "uvx",
-      "args": ["clevertech-mcp-server"]
+      "command": "npx",
+      "args": ["-y", "@clevertech/mcp-server"]
     }
   }
 }
@@ -83,12 +82,16 @@ Add to your MCP configuration:
 ### Direct CLI
 
 ```bash
+# npm (Node.js)
+npx @clevertech/mcp-server
+
+# uv / PyPI
 uvx clevertech-mcp-server
 ```
 
 ---
 
-## Available Tools (12)
+## Available Tools (11)
 
 | Tool | Description |
 |------|-------------|
@@ -135,48 +138,38 @@ Use `list_cities` to see live availability, API capabilities per city, and prope
 
 ## Pricing
 
-No signup required to start. Free tier gives you 50 queries/day out of the box.
+No signup required to start. Free tier gives you 50 queries/day out of the box. All subscription prices are in CAD — see [clevertech.ca/pricing](https://clevertech.ca/pricing) for full details.
 
 | Tier | Queries/Day | Price | API Key |
 |------|-------------|-------|---------|
 | **Free** | 50 | $0 | Not required |
-| **Developer** | 200 | Free | [Sign up →](https://clevertech.ca/keys) |
-| **Pro** | 2,000 | $10/mo | [Sign up →](https://clevertech.ca/keys) |
-| **Enterprise** | 10,000 | $40/mo | [Sign up →](https://clevertech.ca/keys) |
-
-[Get your API key →](https://clevertech.ca/keys)
-
-### Using an API Key
+| **Developer** | 2,000 | $149 CAD/mo | [Sign up →](https://clevertech.ca/keys) |
+| **Team Pro** | 10,000 | $499 CAD/mo | [Sign up →](https://clevertech.ca/keys) |
+| **Enterprise** | Custom | On inquiry | [Contact →](https://clevertech.ca/pricing#enterprise) |
 
-Set the ``CLEVERTECH_API_KEY`` environment variable (recommended):
+**Prepaid bundles** (no subscription; calls never expire): 2,000 calls for $29, 10,000 for $99, or 50,000 for $399 CAD.
 
-```bash
-export CLEVERTECH_API_KEY=your_key_here
-uvx clevertech-mcp-server
-```
+[Get your API key →](https://clevertech.ca/keys) · [View all plans →](https://clevertech.ca/pricing)
 
-Or pass it as a CLI flag:
+### Using an API Key
 
 ```bash
-uvx clevertech-mcp-server --api-key YOUR_KEY
+npx @clevertech/mcp-server --api-key YOUR_KEY
 ```
 
-To get a new key, use device login:
+Or via environment variable:
 
 ```bash
-uvx clevertech-mcp-server --login
+export CLEVERTECH_API_KEY=your_key_here
+npx @clevertech/mcp-server
 ```
 
-This opens a browser for Google sign-in, then prints your API key with
-instructions for setting the environment variable (RFC 8628 device flow).
-The key is **not** saved to disk — you configure it in your MCP client.
-
 ---
 
 ## Features
 
-- **No signup required** — 50 free queries/day out of the box
-- **12 MCP tools** covering property, permits, zoning, business registry, and DLS
+- **No signup required** — free tier with daily API allowance ([pricing](https://clevertech.ca/pricing))
+- **11 MCP tools** covering property, permits, zoning, business registry, and DLS
 - **Batch DLS conversion** — convert up to 100 coordinates in one call
 - **Consolidated property reports** — assessment + permits + zoning + DLS in a single response
 - **stdio transport** — works with Claude Code, Cursor, Cline, GitHub Copilot, and any MCP-compatible agent
@@ -190,15 +183,12 @@ The key is **not** saved to disk — you configure it in your MCP client.
 
 ```bash
 # Clone and set up
-git clone https://github.com/clevertechca/Clevertech-mcp-server.git
-cd Clevertech-mcp-server
+git clone https://github.com/harmssam/clevertech-mcp-server.git
+cd clevertech-mcp-server
 uv sync
 
 # Run locally (stdio transport)
-uv run clevertech-mcp-server
-
-# Run with --login to get an API key
-uv run clevertech-mcp-server --login
+uv run clevertech-mcp-server --transport stdio
 
 # Run with SSE transport (for HTTP-based agents)
 uv run clevertech-mcp-server --transport sse --port 8000
@@ -233,8 +223,10 @@ src/clevertech_mcp/
 
 ## Documentation
 
-- [Tool Reference](docs/tools.md)
+- [Agent Integration Guide](docs/agents.md)
+- [llms.txt](llms.txt) — machine-readable summary for AI agents
 - [MCP Protocol Specification](https://modelcontextprotocol.io)
+- [CleverTech Pricing](https://clevertech.ca/pricing)
 - [CleverTech API Keys](https://clevertech.ca/keys)
 
 ---

{clevertech_mcp_server-0.3.2 → clevertech_mcp_server-0.3.4}/README.md

@@ -1,14 +1,13 @@
 # CleverTech MCP Server
 
-<!-- mcp-name: ca.clevertech/clevertech-mcp-server -->
-
-**Canadian government data for AI agents.** Property assessments, building permits, zoning, business registry, DLS grid conversion — 50 free queries/day, no signup.
+**CleverTech MCP server for AI agents.** Canadian government data — property assessments, building permits, zoning, business registry, and GPS ↔ DLS conversion. Free tier available, no signup.
 
 ```bash
-uvx clevertech-mcp-server
+npx @clevertech/mcp-server
 ```
 
 [![PyPI version](https://badge.fury.io/py/clevertech-mcp-server.svg)](https://pypi.org/project/clevertech-mcp-server/)
+[![npm version](https://badge.fury.io/npm/%40clevertech%2Fmcp-server.svg)](https://www.npmjs.com/package/@clevertech/mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 ---
@@ -23,8 +22,8 @@ Add to your `~/.claude/claude_desktop_config.json`:
 {
   "mcpServers": {
     "clevertech": {
-      "command": "uvx",
-      "args": ["clevertech-mcp-server"]
+      "command": "npx",
+      "args": ["-y", "@clevertech/mcp-server"]
     }
   }
 }
@@ -51,8 +50,8 @@ Add to your MCP configuration:
 {
   "mcpServers": {
     "clevertech": {
-      "command": "uvx",
-      "args": ["clevertech-mcp-server"]
+      "command": "npx",
+      "args": ["-y", "@clevertech/mcp-server"]
     }
   }
 }
@@ -61,12 +60,16 @@ Add to your MCP configuration:
 ### Direct CLI
 
 ```bash
+# npm (Node.js)
+npx @clevertech/mcp-server
+
+# uv / PyPI
 uvx clevertech-mcp-server
 ```
 
 ---
 
-## Available Tools (12)
+## Available Tools (11)
 
 | Tool | Description |
 |------|-------------|
@@ -113,48 +116,38 @@ Use `list_cities` to see live availability, API capabilities per city, and prope
 
 ## Pricing
 
-No signup required to start. Free tier gives you 50 queries/day out of the box.
+No signup required to start. Free tier gives you 50 queries/day out of the box. All subscription prices are in CAD — see [clevertech.ca/pricing](https://clevertech.ca/pricing) for full details.
 
 | Tier | Queries/Day | Price | API Key |
 |------|-------------|-------|---------|
 | **Free** | 50 | $0 | Not required |
-| **Developer** | 200 | Free | [Sign up →](https://clevertech.ca/keys) |
-| **Pro** | 2,000 | $10/mo | [Sign up →](https://clevertech.ca/keys) |
-| **Enterprise** | 10,000 | $40/mo | [Sign up →](https://clevertech.ca/keys) |
-
-[Get your API key →](https://clevertech.ca/keys)
-
-### Using an API Key
+| **Developer** | 2,000 | $149 CAD/mo | [Sign up →](https://clevertech.ca/keys) |
+| **Team Pro** | 10,000 | $499 CAD/mo | [Sign up →](https://clevertech.ca/keys) |
+| **Enterprise** | Custom | On inquiry | [Contact →](https://clevertech.ca/pricing#enterprise) |
 
-Set the ``CLEVERTECH_API_KEY`` environment variable (recommended):
+**Prepaid bundles** (no subscription; calls never expire): 2,000 calls for $29, 10,000 for $99, or 50,000 for $399 CAD.
 
-```bash
-export CLEVERTECH_API_KEY=your_key_here
-uvx clevertech-mcp-server
-```
+[Get your API key →](https://clevertech.ca/keys) · [View all plans →](https://clevertech.ca/pricing)
 
-Or pass it as a CLI flag:
+### Using an API Key
 
 ```bash
-uvx clevertech-mcp-server --api-key YOUR_KEY
+npx @clevertech/mcp-server --api-key YOUR_KEY
 ```
 
-To get a new key, use device login:
+Or via environment variable:
 
 ```bash
-uvx clevertech-mcp-server --login
+export CLEVERTECH_API_KEY=your_key_here
+npx @clevertech/mcp-server
 ```
 
-This opens a browser for Google sign-in, then prints your API key with
-instructions for setting the environment variable (RFC 8628 device flow).
-The key is **not** saved to disk — you configure it in your MCP client.
-
 ---
 
 ## Features
 
-- **No signup required** — 50 free queries/day out of the box
-- **12 MCP tools** covering property, permits, zoning, business registry, and DLS
+- **No signup required** — free tier with daily API allowance ([pricing](https://clevertech.ca/pricing))
+- **11 MCP tools** covering property, permits, zoning, business registry, and DLS
 - **Batch DLS conversion** — convert up to 100 coordinates in one call
 - **Consolidated property reports** — assessment + permits + zoning + DLS in a single response
 - **stdio transport** — works with Claude Code, Cursor, Cline, GitHub Copilot, and any MCP-compatible agent
@@ -168,15 +161,12 @@ The key is **not** saved to disk — you configure it in your MCP client.
 
 ```bash
 # Clone and set up
-git clone https://github.com/clevertechca/Clevertech-mcp-server.git
-cd Clevertech-mcp-server
+git clone https://github.com/harmssam/clevertech-mcp-server.git
+cd clevertech-mcp-server
 uv sync
 
 # Run locally (stdio transport)
-uv run clevertech-mcp-server
-
-# Run with --login to get an API key
-uv run clevertech-mcp-server --login
+uv run clevertech-mcp-server --transport stdio
 
 # Run with SSE transport (for HTTP-based agents)
 uv run clevertech-mcp-server --transport sse --port 8000
@@ -211,8 +201,10 @@ src/clevertech_mcp/
 
 ## Documentation
 
-- [Tool Reference](docs/tools.md)
+- [Agent Integration Guide](docs/agents.md)
+- [llms.txt](llms.txt) — machine-readable summary for AI agents
 - [MCP Protocol Specification](https://modelcontextprotocol.io)
+- [CleverTech Pricing](https://clevertech.ca/pricing)
 - [CleverTech API Keys](https://clevertech.ca/keys)
 
 ---

{clevertech_mcp_server-0.3.2 → clevertech_mcp_server-0.3.4}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "clevertech-mcp-server"
-version = "0.3.2"
-description = "MCP Server for CleverTech Canadian government data APIs"
+version = "0.3.4"
+description = "CleverTech MCP server — Canadian government data for AI agents: property, permits, zoning, business registry, and GPS ↔ DLS conversion. Free tier available."
 readme = "README.md"
 requires-python = ">=3.11"
 license = {text = "MIT"}
@@ -37,5 +37,4 @@ packages = ["src/clevertech_mcp"]
 dev = [
     "pytest>=9.0.3",
     "pytest-asyncio>=1.4.0",
-    "ruff>=0.9.0",
 ]

{clevertech_mcp_server-0.3.2 → clevertech_mcp_server-0.3.4}/src/clevertech_mcp/auth.py

@@ -15,7 +15,7 @@ import contextvars
 from typing import Optional, TYPE_CHECKING
 
 if TYPE_CHECKING:
-    pass
+    from starlette.requests import Request
 
 # ContextVar bridge for SSE transport.
 # Set by Starlette middleware on the initial SSE connection request.

{clevertech_mcp_server-0.3.2 → clevertech_mcp_server-0.3.4}/src/clevertech_mcp/rate_limit.py

@@ -8,6 +8,7 @@ Tracks requests per source IP using a sliding-window approach:
 
 import time
 import threading
+from typing import Optional
 
 
 class LocalRateLimiter:

{clevertech_mcp_server-0.3.2 → clevertech_mcp_server-0.3.4}/src/clevertech_mcp/server.py

@@ -3,7 +3,10 @@ CleverTech MCP Server — main entry point.
 """
 
 import os
+import sys
 import argparse
+import json
+import contextvars
 from mcp.server.fastmcp import FastMCP
 from starlette.middleware.base import BaseHTTPMiddleware
 from starlette.responses import HTMLResponse, JSONResponse
@@ -417,6 +420,30 @@ uv run clevertech-mcp-server</pre>
     </div>
   </section>
 
+  <!-- ── PRICING ──────────────────────────────────────────── -->
+  <section>
+    <h2>Pricing</h2>
+    <div class="card" style="font-size:0.88rem;">
+      <p>No signup required to start. <strong>Free tier</strong> included &mdash; see
+        <a href="https://clevertech.ca/pricing" style="color:#0dc5b8;">clevertech.ca/pricing</a>
+        for daily allowance. All prices in CAD.</p>
+      <table style="width:100%;margin-top:0.75rem;border-collapse:collapse;font-size:0.85rem;">
+        <tr style="border-bottom:1px solid #1a3550;">
+          <th style="text-align:left;padding:0.4rem 0;color:#0dc5b8;">Tier</th>
+          <th style="text-align:left;padding:0.4rem 0;color:#0dc5b8;">Price</th>
+        </tr>
+        <tr style="border-bottom:1px solid #1a3550;"><td style="padding:0.35rem 0;">Free</td><td>Free tier</td></tr>
+        <tr style="border-bottom:1px solid #1a3550;"><td style="padding:0.35rem 0;">Prepaid</td><td>$29 (2,000 calls)</td></tr>
+        <tr style="border-bottom:1px solid #1a3550;"><td style="padding:0.35rem 0;">Developer</td><td>$149/mo</td></tr>
+        <tr style="border-bottom:1px solid #1a3550;"><td style="padding:0.35rem 0;">Team Pro</td><td>$499/mo</td></tr>
+        <tr><td style="padding:0.35rem 0;">Enterprise</td><td>Custom</td></tr>
+      </table>
+      <p style="margin-top:0.75rem;">
+        <a href="https://clevertech.ca/keys" style="color:#0dc5b8;">Get your API key &rarr;</a>
+      </p>
+    </div>
+  </section>
+
   <!-- ── AUTHENTICATION ───────────────────────────────────── -->
   <section>
     <h2>Authentication &amp; Rate Limits</h2>
@@ -570,29 +597,15 @@ def main():
         default=None,
         help="CleverTech API key (overrides CLEVERTECH_API_KEY env var)",
     )
-    parser.add_argument(
-        "--login",
-        action="store_true",
-        default=False,
-        help="Authenticate via device authorization flow and print API key",
-    )
     args = parser.parse_args()
 
     config = load_config()
     config["host"] = args.host
     config["port"] = args.port
 
-    # Resolve API key priority: --api-key > CLEVERTECH_API_KEY env var > --login
+    # --api-key flag overrides env var for stdio mode
     if args.api_key:
         config["api_key"] = args.api_key
-        os.environ["CLEVERTECH_API_KEY"] = args.api_key
-    elif os.getenv("CLEVERTECH_API_KEY"):
-        config["api_key"] = os.getenv("CLEVERTECH_API_KEY")
-    elif args.login:
-        from clevertech_mcp.login import device_login
-        api_key = device_login(config.get("api_url", "https://clevertech.ca"))
-        config["api_key"] = api_key
-        os.environ["CLEVERTECH_API_KEY"] = api_key
 
     mcp = create_server(config)
 

{clevertech_mcp_server-0.3.2 → clevertech_mcp_server-0.3.4}/src/clevertech_mcp/tools/building.py

@@ -6,39 +6,6 @@ from clevertech_mcp.rate_limit import LocalRateLimiter
 from clevertech_mcp.auth import _get_user_api_key, get_upstream_key, is_authenticated, _extract_client_ip
 
 
-def _permit_id(r: dict) -> str:
-    """Upstream uses permit_id; older fixtures/docs used permit_number."""
-    return r.get("permit_id") or r.get("permit_number") or "N/A"
-
-
-def _permit_value(r: dict):
-    """Upstream uses estimated_value; older fixtures used job_value."""
-    if r.get("estimated_value") is not None:
-        return r.get("estimated_value")
-    return r.get("job_value")
-
-
-def _permit_issued(r: dict) -> str:
-    """Upstream uses issue_date; older fixtures used issued_date."""
-    return r.get("issue_date") or r.get("issued_date") or "N/A"
-
-
-def _format_permit_block(r: dict) -> list[str]:
-    value = _permit_value(r)
-    value_line = f"Value: ${value:,.0f}" if value is not None else "Value: N/A"
-    return [
-        "",
-        "---",
-        f"Permit: {_permit_id(r)}",
-        f"Type: {r.get('permit_type', 'N/A')}",
-        f"Status: {r.get('status', 'N/A')}",
-        f"Address: {r.get('address', 'N/A')}",
-        f"Applicant: {r.get('applicant', 'N/A')}",
-        value_line,
-        f"Issued: {_permit_issued(r)}",
-    ]
-
-
 def register_building_tools(mcp: FastMCP, client: CleverTechClient, config: dict, rate_limiter: LocalRateLimiter):
     """Register building permit tools."""
 
@@ -83,7 +50,17 @@ def register_building_tools(mcp: FastMCP, client: CleverTechClient, config: dict
             lines.append(f"\n{message}")
 
         for r in results:
-            lines.extend(_format_permit_block(r))
+            lines.extend([
+                "",
+                "---",
+                f"Permit: {r.get('permit_number', 'N/A')}",
+                f"Type: {r.get('permit_type', 'N/A')}",
+                f"Status: {r.get('status', 'N/A')}",
+                f"Address: {r.get('address', 'N/A')}",
+                f"Applicant: {r.get('applicant', 'N/A')}",
+                f"Value: ${r.get('job_value', 0):,.0f}" if r.get('job_value') is not None else "Value: N/A",
+                f"Issued: {r.get('issued_date', 'N/A')}",
+            ])
 
         return "\n".join(lines)
 
@@ -123,6 +100,15 @@ def register_building_tools(mcp: FastMCP, client: CleverTechClient, config: dict
             lines.append(f"\n{message}")
 
         for r in results:
-            lines.extend(_format_permit_block(r))
+            lines.extend([
+                "",
+                "---",
+                f"Permit: {r.get('permit_number', 'N/A')}",
+                f"Type: {r.get('permit_type', 'N/A')}",
+                f"Status: {r.get('status', 'N/A')}",
+                f"Address: {r.get('address', 'N/A')}",
+                f"Value: ${r.get('job_value', 0):,.0f}" if r.get('job_value') is not None else "Value: N/A",
+                f"Issued: {r.get('issued_date', 'N/A')}",
+            ])
 
         return "\n".join(lines)

{clevertech_mcp_server-0.3.2 → clevertech_mcp_server-0.3.4}/src/clevertech_mcp/tools/business.py

@@ -37,7 +37,6 @@ def register_business_tools(mcp: FastMCP, client: CleverTechClient, config: dict
             source_ip = _extract_client_ip(ctx)
             rate_limiter.check_or_raise(source_ip)
 
-        # Use advanced endpoint for full parameter support
         params = {"q": q, "limit": min(limit, 100)}
         if province:
             params["province"] = province
@@ -57,26 +56,14 @@ def register_business_tools(mcp: FastMCP, client: CleverTechClient, config: dict
             lines.append(f"\n{message}")
 
         for r in results:
-            # Upstream API field names: name, corporation_id, status_en,
-            # province_en, city, incorporation_date, act_en, corporation_type_en
             lines.extend([
                 "",
                 "---",
-                f"Name: {r.get('name', r.get('corporation_name', 'N/A'))}",
-                f"Number: {r.get('corporation_id', r.get('corporation_number', r.get('number', 'N/A')))}",
-                f"Status: {r.get('status_en', r.get('status', 'N/A'))}",
-                f"Province: {r.get('province_en', r.get('province', 'N/A'))}",
+                f"Name: {r.get('corporation_name', r.get('name', 'N/A'))}",
+                f"Number: {r.get('corporation_number', r.get('number', 'N/A'))}",
+                f"Status: {r.get('status', 'N/A')}",
+                f"Jurisdiction: {r.get('jurisdiction', r.get('province', 'N/A'))}",
             ])
-            if r.get('city'):
-                lines.append(f"City: {r['city']}")
-            if r.get('incorporation_date'):
-                lines.append(f"Incorporated: {r['incorporation_date']}")
-            if r.get('act_en'):
-                lines.append(f"Act: {r['act_en']}")
-            if r.get('corporation_type_en'):
-                lines.append(f"Type: {r['corporation_type_en']}")
-            if r.get('latest_filing_year'):
-                lines.append(f"Latest Filing: {r['latest_filing_year']}")
             if r.get('registered_address'):
                 lines.append(f"Address: {r['registered_address']}")