clevertech-mcp-server 0.1.0__tar.gz

clevertech_mcp_server-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  pypi-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish --token ${{ secrets.PYPI_TOKEN }}
+
+  npm-publish:
+    name: Publish npm shim
+    runs-on: ubuntu-latest
+    needs: pypi-publish
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

clevertech_mcp_server-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,38 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.11', '3.12']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Lint with ruff
+        run: uv run ruff check src/ tests/
+
+      - name: Test with pytest
+        run: uv run pytest -v tests/

clevertech_mcp_server-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+
+# Virtual environments
+.venv/
+env/
+venv/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+
+# uv (lockfile is committed for reproducible builds — keep commented)
+# uv.lock

clevertech_mcp_server-0.1.0/Dockerfile

@@ -0,0 +1,22 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends ca-certificates && \
+    rm -rf /var/lib/apt/lists/*
+
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+
+COPY pyproject.toml README.md uv.lock ./
+COPY src/ ./src/
+
+RUN uv sync --frozen --no-dev
+
+# PORT is set by Railway platform automatically — don't override
+# The CMD defaults to $PORT (from env) or 8001 locally
+ENV LOG_LEVEL=INFO
+ENV TRANSPORT=sse
+
+# Use shell form so $PORT from Railway is respected (default 8001 locally)
+CMD uv run clevertech-mcp-server --transport sse --host 0.0.0.0 --port ${PORT:-8001}

clevertech_mcp_server-0.1.0/LICENSE

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

clevertech_mcp_server-0.1.0/PKG-INFO

@@ -0,0 +1,232 @@
+Metadata-Version: 2.4
+Name: clevertech-mcp-server
+Version: 0.1.0
+Summary: MCP Server for CleverTech Canadian government data APIs
+Author-email: CleverTech <dev@clevertech.ca>
+License: MIT
+License-File: LICENSE
+Keywords: canada,dls,gis,land-survey,mcp,property
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: starlette>=0.36.0
+Requires-Dist: uvicorn>=0.27.0
+Description-Content-Type: text/markdown
+
+# 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.
+
+```bash
+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)
+
+---
+
+## Quick Start
+
+### Claude Code
+
+Add to your `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "clevertech": {
+      "command": "npx",
+      "args": ["-y", "@clevertech/mcp-server"]
+    }
+  }
+}
+```
+
+### Cursor / Cline
+
+Add to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "clevertech": {
+      "command": "uvx",
+      "args": ["clevertech-mcp-server"]
+    }
+  }
+}
+```
+
+### GitHub Copilot
+
+```json
+{
+  "mcpServers": {
+    "clevertech": {
+      "command": "npx",
+      "args": ["-y", "@clevertech/mcp-server"]
+    }
+  }
+}
+```
+
+### Direct CLI
+
+```bash
+# npm (Node.js)
+npx @clevertech/mcp-server
+
+# uv / PyPI
+uvx clevertech-mcp-server
+```
+
+---
+
+## Available Tools (11)
+
+| Tool | Description |
+|------|-------------|
+| `dls_convert` | GPS ↔ Dominion Land Survey (DLS) coordinate conversion for Western Canada |
+| `dls_batch` | Batch GPS ↔ DLS conversion — up to 100 coordinates at once |
+| `property_search` | Property assessment search by address across 13+ Canadian cities |
+| `property_report` | Consolidated property report — assessment, permits, zoning, and DLS in one call |
+| `property_by_roll` | Direct property lookup by roll number — faster than address search |
+| `building_permit_search` | Building permit search by address, contractor, applicant, or permit number |
+| `building_permit_recent` | Recently issued building permits feed — monitor new construction activity |
+| `zoning_lookup` | Zoning district lookup by GPS coordinates or street address |
+| `business_registry_search` | Federal corporation search — find Canadian businesses by name, province, or city |
+| `reverse_geocode` | GPS → address, city, neighborhood, province, and DLS grid reference |
+| `list_cities` | Discover available cities, their API capabilities, and property counts |
+
+### What Agents Can Do
+
+- **Ask**: *"What's 1532 14 Ave SW in Calgary worth?"* — Gets assessed value, land value, building value, year built, lot size, and DLS coordinates.
+- **Ask**: *"Show me recent building permits in Vancouver"* — Returns the latest construction permits with type, value, status, and issue dates.
+- **Ask**: *"What zone is this GPS point in?"* — Looks up zoning district, land use, and boundary info.
+- **Ask**: *"Convert these 50 GPS points to DLS"* — Batch converts in a single API call.
+- **Ask**: *"Is Shopify still an active corporation?"* — Searches the federal business registry.
+
+---
+
+## Cities Supported
+
+**20 cities** across Canada — and growing:
+
+| Province | Cities |
+|----------|--------|
+| Alberta | Calgary, Edmonton, High River |
+| British Columbia | Vancouver, Victoria |
+| Ontario | Toronto, Ottawa, Hamilton, Kitchener, London, Mississauga, Markham, Vaughan |
+| Quebec | Montreal, Quebec City |
+| Manitoba | Winnipeg |
+| Saskatchewan | Saskatoon, Regina |
+| Nova Scotia | Halifax |
+| Newfoundland | St. John's |
+
+Use `list_cities` to see live availability, API capabilities per city, and property counts.
+
+---
+
+## Pricing
+
+No signup required to start. Free tier gives you 50 queries/day out of the box.
+
+| 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
+
+```bash
+npx @clevertech/mcp-server --api-key YOUR_KEY
+```
+
+Or via environment variable:
+
+```bash
+export CLEVERTECH_API_KEY=your_key_here
+npx @clevertech/mcp-server
+```
+
+---
+
+## Features
+
+- **No signup required** — 50 free queries/day out of the box
+- **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 + SSE transport** — works with Claude Code, Cursor, Cline, GitHub Copilot, and any MCP-compatible agent
+- **Clean text output** — formatted for easy LLM parsing and reformatting
+- **20 Canadian cities** — urban and rural coverage with regular additions
+- **MIT licensed** — use it anywhere, no restrictions
+
+---
+
+## Development
+
+```bash
+# Clone and set up
+git clone https://github.com/anteriorclever/clevertech-mcp-server.git
+cd clevertech-mcp-server
+uv sync
+
+# Run locally (stdio transport)
+uv run clevertech-mcp-server --transport stdio
+
+# Run with SSE transport (for HTTP-based agents)
+uv run clevertech-mcp-server --transport sse --port 8000
+```
+
+### Run Tests
+
+```bash
+uv run pytest
+```
+
+### Project Structure
+
+```
+src/clevertech_mcp/
+├── tools/
+│   ├── property.py    # property_search, property_report, property_by_roll
+│   ├── building.py    # building_permit_search, building_permit_recent
+│   ├── zoning.py      # zoning_lookup
+│   ├── dls.py         # dls_convert, dls_batch
+│   ├── business.py    # business_registry_search
+│   ├── geo.py         # reverse_geocode
+│   └── meta.py        # list_cities
+├── server.py          # FastMCP server entry point
+├── client.py          # HTTP client for CleverTech API
+├── auth.py            # API key authentication
+├── rate_limit.py      # Rate limiting
+└── config.py          # Configuration management
+```
+
+---
+
+## Documentation
+
+- [Tool Reference](docs/tools.md)
+- [MCP Protocol Specification](https://modelcontextprotocol.io)
+- [CleverTech API Keys](https://clevertech.ca/keys)
+
+---
+
+## License
+
+MIT © 2026 CleverTech — see [LICENSE](LICENSE) for details.

clevertech_mcp_server-0.1.0/README.md

@@ -0,0 +1,210 @@
+# 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.
+
+```bash
+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)
+
+---
+
+## Quick Start
+
+### Claude Code
+
+Add to your `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "clevertech": {
+      "command": "npx",
+      "args": ["-y", "@clevertech/mcp-server"]
+    }
+  }
+}
+```
+
+### Cursor / Cline
+
+Add to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "clevertech": {
+      "command": "uvx",
+      "args": ["clevertech-mcp-server"]
+    }
+  }
+}
+```
+
+### GitHub Copilot
+
+```json
+{
+  "mcpServers": {
+    "clevertech": {
+      "command": "npx",
+      "args": ["-y", "@clevertech/mcp-server"]
+    }
+  }
+}
+```
+
+### Direct CLI
+
+```bash
+# npm (Node.js)
+npx @clevertech/mcp-server
+
+# uv / PyPI
+uvx clevertech-mcp-server
+```
+
+---
+
+## Available Tools (11)
+
+| Tool | Description |
+|------|-------------|
+| `dls_convert` | GPS ↔ Dominion Land Survey (DLS) coordinate conversion for Western Canada |
+| `dls_batch` | Batch GPS ↔ DLS conversion — up to 100 coordinates at once |
+| `property_search` | Property assessment search by address across 13+ Canadian cities |
+| `property_report` | Consolidated property report — assessment, permits, zoning, and DLS in one call |
+| `property_by_roll` | Direct property lookup by roll number — faster than address search |
+| `building_permit_search` | Building permit search by address, contractor, applicant, or permit number |
+| `building_permit_recent` | Recently issued building permits feed — monitor new construction activity |
+| `zoning_lookup` | Zoning district lookup by GPS coordinates or street address |
+| `business_registry_search` | Federal corporation search — find Canadian businesses by name, province, or city |
+| `reverse_geocode` | GPS → address, city, neighborhood, province, and DLS grid reference |
+| `list_cities` | Discover available cities, their API capabilities, and property counts |
+
+### What Agents Can Do
+
+- **Ask**: *"What's 1532 14 Ave SW in Calgary worth?"* — Gets assessed value, land value, building value, year built, lot size, and DLS coordinates.
+- **Ask**: *"Show me recent building permits in Vancouver"* — Returns the latest construction permits with type, value, status, and issue dates.
+- **Ask**: *"What zone is this GPS point in?"* — Looks up zoning district, land use, and boundary info.
+- **Ask**: *"Convert these 50 GPS points to DLS"* — Batch converts in a single API call.
+- **Ask**: *"Is Shopify still an active corporation?"* — Searches the federal business registry.
+
+---
+
+## Cities Supported
+
+**20 cities** across Canada — and growing:
+
+| Province | Cities |
+|----------|--------|
+| Alberta | Calgary, Edmonton, High River |
+| British Columbia | Vancouver, Victoria |
+| Ontario | Toronto, Ottawa, Hamilton, Kitchener, London, Mississauga, Markham, Vaughan |
+| Quebec | Montreal, Quebec City |
+| Manitoba | Winnipeg |
+| Saskatchewan | Saskatoon, Regina |
+| Nova Scotia | Halifax |
+| Newfoundland | St. John's |
+
+Use `list_cities` to see live availability, API capabilities per city, and property counts.
+
+---
+
+## Pricing
+
+No signup required to start. Free tier gives you 50 queries/day out of the box.
+
+| 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
+
+```bash
+npx @clevertech/mcp-server --api-key YOUR_KEY
+```
+
+Or via environment variable:
+
+```bash
+export CLEVERTECH_API_KEY=your_key_here
+npx @clevertech/mcp-server
+```
+
+---
+
+## Features
+
+- **No signup required** — 50 free queries/day out of the box
+- **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 + SSE transport** — works with Claude Code, Cursor, Cline, GitHub Copilot, and any MCP-compatible agent
+- **Clean text output** — formatted for easy LLM parsing and reformatting
+- **20 Canadian cities** — urban and rural coverage with regular additions
+- **MIT licensed** — use it anywhere, no restrictions
+
+---
+
+## Development
+
+```bash
+# Clone and set up
+git clone https://github.com/anteriorclever/clevertech-mcp-server.git
+cd clevertech-mcp-server
+uv sync
+
+# Run locally (stdio transport)
+uv run clevertech-mcp-server --transport stdio
+
+# Run with SSE transport (for HTTP-based agents)
+uv run clevertech-mcp-server --transport sse --port 8000
+```
+
+### Run Tests
+
+```bash
+uv run pytest
+```
+
+### Project Structure
+
+```
+src/clevertech_mcp/
+├── tools/
+│   ├── property.py    # property_search, property_report, property_by_roll
+│   ├── building.py    # building_permit_search, building_permit_recent
+│   ├── zoning.py      # zoning_lookup
+│   ├── dls.py         # dls_convert, dls_batch
+│   ├── business.py    # business_registry_search
+│   ├── geo.py         # reverse_geocode
+│   └── meta.py        # list_cities
+├── server.py          # FastMCP server entry point
+├── client.py          # HTTP client for CleverTech API
+├── auth.py            # API key authentication
+├── rate_limit.py      # Rate limiting
+└── config.py          # Configuration management
+```
+
+---
+
+## Documentation
+
+- [Tool Reference](docs/tools.md)
+- [MCP Protocol Specification](https://modelcontextprotocol.io)
+- [CleverTech API Keys](https://clevertech.ca/keys)
+
+---
+
+## License
+
+MIT © 2026 CleverTech — see [LICENSE](LICENSE) for details.

clevertech_mcp_server-0.1.0/bin/run.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+const { execSync, spawn } = require('child_process');
+const path = require('path');
+
+function checkCommand(cmd) {
+    try { execSync(`which ${cmd}`, { stdio: 'ignore' }); return true; }
+    catch { return false; }
+}
+
+if (!checkCommand('python3') && !checkCommand('python')) {
+    console.error('Python 3.11+ is required. Install from https://python.org');
+    process.exit(1);
+}
+if (!checkCommand('uv') && !checkCommand('uvx')) {
+    console.error('uv is required. Install: curl -LsSf https://astral.sh/uv/install.sh | sh');
+    process.exit(1);
+}
+
+const args = process.argv.slice(2);
+const child = spawn('uvx', ['clevertech-mcp-server', ...args], {
+    stdio: 'inherit',
+    env: process.env
+});
+child.on('exit', code => process.exit(code));

clevertech_mcp_server-0.1.0/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@clevertech/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP Server for CleverTech Canadian government data APIs — property assessments, building permits, zoning, DLS grid conversion, business registry.",
+  "bin": {
+    "clevertech-mcp-server": "./bin/run.js"
+  },
+  "files": ["bin/", "README.md"],
+  "keywords": ["mcp", "clevertech", "canada", "property", "assessment", "dls", "building-permits", "zoning", "real-estate", "gis"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anteriorclever/clevertech-mcp-server.git"
+  },
+  "license": "MIT"
+}

clevertech_mcp_server-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[project]
+name = "clevertech-mcp-server"
+version = "0.1.0"
+description = "MCP Server for CleverTech Canadian government data APIs"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [{name = "CleverTech", email = "dev@clevertech.ca"}]
+keywords = ["mcp", "canada", "property", "land-survey", "dls", "gis"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+    "pydantic>=2.0.0",
+    "python-dotenv>=1.0.0",
+    "starlette>=0.36.0",
+    "uvicorn>=0.27.0",
+]
+
+[project.scripts]
+clevertech-mcp-server = "clevertech_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/clevertech_mcp"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.4.0",
+]

clevertech_mcp_server-0.1.0/railway.toml

@@ -0,0 +1,12 @@
+[deploy]
+healthcheckPath = "/health"
+healthcheckTimeout = 120
+restartPolicyType = "ON_FAILURE"
+restartPolicyMaxRetries = 3
+
+# Environment variables set in Railway dashboard:
+# CLEVERTECH_API_URL = https://clevertech.ca
+# CLEVERTECH_API_KEY = ctk_mcp_svc_... (internal server key)
+# TRANSPORT = sse
+# LOG_LEVEL = INFO
+# RATE_LIMIT_ANON_DAILY = 50