MontrealPermitOracle

Montreal Construction Oracle (MCP) Real-time building permit intelligence for the AI age.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Get Recent Permits: Return building permits issued in the given Montreal borough within the last N days. Borough matching is case-insensitive and supports partial names (e.g. 'plateau' matches 'Le Pla
  • Get High Value Permits: Return large-scale building permits filtered by estimated work cost. NOTE: the Montreal Open Data CSV does not currently publish the 'cout_travaux_estimes' column. This tool us
  • List Boroughs: List all 19 distinct borough (arrondissement) names found in the permit dataset. Use the returned names as input to get_recent_permits().

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Montreal Construction Oracle (MCP) Real-time building permit intelligence for the AI age.

The Montreal Construction Oracle is a specialized Model Context Protocol (MCP) server that provides structured, real-time access to building permit data from the City of Montreal.

Instead of manually digging through messy government CSVs, this server allows AI agents (like Claude, ChatGPT, or custom enterprise bots) to instantly query high-value construction leads, renovation trends, and urban development data.

🚀 Features Real-Time Scraping: Directly interfaces with the Montreal Open Data Portal.

High-Value Filtering: Instantly identify projects with budgets over $100k, $1M, or custom thresholds.

Agent-Native: Built specifically for the Model Context Protocol, meaning it "explains itself" to any AI agent that connects to it.

Borough Specific: Query permits by arrondissement (e.g., Plateau-Mont-Royal, Ville-Marie, Westmount).

🛠️ MCP Tools Once connected, your AI agent will have access to the following capabilities:

get_recent_permits Fetch a list of permits issued within a specific timeframe and borough.

Arguments: borough (string), days (number)

get_high_value_permits Scan for "Big Fish" projects that meet a specific estimated cost requirement.

Arguments: min_cost (number), borough (optional)

⚡ Quick Start (for AI Agents) To use this server with your local agent (e.g., Claude Desktop), add the following to your configuration:

JSON { "mcpServers": { "mtl-construction-oracle": { "command": "python", "args": ["server.py", "--transport", "http"], "env": { "X_API_KEY": "YOUR_SECRET_KEY" } } } } 💼 Commercial Use & API Keys This server is built for professional real estate developers, contractors, and lead-generation firms.

Want to monetize this? Access to the live endpoint requires an API key. To get your own or to partner for a specific territory, contact the founder via GitHub Issues or at [Insert your email/link here].

🛡️ Data Source Data is sourced from the Ville de Montréal Open Data Portal. This tool is an independent implementation and is not officially affiliated with the municipal government.

Why this README works: The "Hook": It immediately identifies as an MCP server (the hottest tech in 2026).

The Value: It highlights "High-Value Filtering," which is what contractors care about.

The Paywall: It subtly mentions that keys are required for commercial use, setting the stage for your revenue.

Once you save this file, commit and push it to GitHub using that token you just generated. Your business is officially "dressed to impress

Как подключить

Как подключить MontrealPermitOracle к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://montrealpermitoracle--maximeproulx4.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить MontrealPermitOracle к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://montrealpermitoracle--maximeproulx4.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить MontrealPermitOracle к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://montrealpermitoracle--maximeproulx4.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (4)

Технические названия из tools/list. Нужны только разработчикам.

get_recent_permitsReturn building permits issued in the given Montreal borough within the last N days. Borough matching is case-insensitive and supports partial names (e.g. 'plateau' matches 'Le Plateau-Mont-Royal').
get_high_value_permitsReturn large-scale building permits filtered by estimated work cost. NOTE: the Montreal Open Data CSV does not currently publish the 'cout_travaux_estimes' column. This tool uses 'nb_logements' (housing unit count) as a scale proxy: min_cost is divided by 100 000 to derive the minimum unit threshold. Results are sorted largest-first. The tool will automatically switch to real cost data if the column appears in a future dataset update.
list_boroughsList all 19 distinct borough (arrondissement) names found in the permit dataset. Use the returned names as input to get_recent_permits().
reload_dataClear the session cache and re-download the permit CSV from the Montreal Open Data portal. Useful if the dataset has been updated since the server started.