Bucky

Official12 tools

by markbucky

Zoning, parcel, and development feasibility for a street address in Canada and the US.

com.buckybuild/bucky (Model Context Protocol Server)

The com.buckybuild/bucky MCP server provides zoning, parcel, and development feasibility for a given street address in Canada and the US. It is exposed as a tool-based service (toolCount: 10) intended to support address-level research and planning questions.

🛠️ Key Features

Zoning analysis for a street address
Parcel information for a street address
Development feasibility evaluation
Coverage: Canada and the US

🚀 Use Cases

Check zoning context for a proposed address
Review parcel-related details for a specific location
Assess development feasibility for address-level planning

⚡ Developer Benefits

Tool-based integration with 10 available tools
Address-driven inputs for Canada and US workflows

⚠️ Limitations

Scope limited to zoning, parcel, and development feasibility
Description provided does not specify depth, coverage granularity, or output formats

Captured live from the server via tools/list.

getBuckyMcpGuide

Return what this session should do next. Call it with no arguments on first contact. With no token: the tools that work now (including a free site preview), and how to start OAuth by calling a gated tool. Signed in with no projects: three onboarding questions, not the tool catalogue — answer them by calling this tool again with role, market and scale, and it returns one workflow to run. Signed in with projects: the most recent projects and one next call derived from this account's own incompleteness (unresolved geography, missing analysis, or missing report), falling back to getProjectContext when nothing is unfinished. The anonymous path makes no database call. A signed-in call reads this account's project membership and incompleteness flags only — no geocoder, model, third-party API, PostHog, or meter.

Parameters4

role	string	optional	Who is asking. Answers "Developer, GC, or municipal reviewer?".
market	string	optional	Which country the site is in. Answers "US or Canada?".
scale	string	optional	One site or several. Answers "Single parcel, or a portfolio?".
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "role": {
      "description": "Who is asking. Answers \"Developer, GC, or municipal reviewer?\".",
      "type": "string",
      "enum": [
        "developer",
        "gc",
        "reviewer"
      ]
    },
    "market": {
      "description": "Which country the site is in. Answers \"US or Canada?\".",
      "type": "string",
      "enum": [
        "US",
        "CA"
      ]
    },
    "scale": {
      "description": "One site or several. Answers \"Single parcel, or a portfolio?\".",
      "type": "string",
      "enum": [
        "single_parcel",
        "portfolio"
      ]
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

explainFeasibilityStatus

Explain one Bucky coverage or per-fact provenance status and the safe next action. This is a pure static lookup: it does not inspect an address, retrieve property data, or call a database, geocoder, AI model, or third-party API. Accepts exactly one of: live, live_unavailable, planned_not_live, geo_division_uncatalogued, unseeded_place, geocode_failed, cited, cited_conditional, conditional_unresolved, no_limit_in_bylaw, not_extracted, site_specific_schedule, unverified_default.

Parameters2

status	string	required	A Bucky coverage resolution status or per-fact provenance status returned by a feasibility result. Must be copied verbatim from a feasibility result — one of: live, live_unavailable, planned_not_live, geo_division_uncatalogued, unseeded_place, geocode_failed, cited, cited_conditional, conditional_unresolved, no_limit_in_bylaw, not_extracted, site_specific_schedule, unverified_default, derived_from_cited, defaulted, missing. Do not paraphrase or invent a status.
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "live",
        "live_unavailable",
        "planned_not_live",
        "geo_division_uncatalogued",
        "unseeded_place",
        "geocode_failed",
        "cited",
        "cited_conditional",
        "conditional_unresolved",
        "no_limit_in_bylaw",
        "not_extracted",
        "site_specific_schedule",
        "unverified_default",
        "derived_from_cited",
        "defaulted",
        "missing"
      ],
      "description": "A Bucky coverage resolution status or per-fact provenance status returned by a feasibility result. Must be copied verbatim from a feasibility result — one of: live, live_unavailable, planned_not_live, geo_division_uncatalogued, unseeded_place, geocode_failed, cited, cited_conditional, conditional_unresolved, no_limit_in_bylaw, not_extracted, site_specific_schedule, unverified_default, derived_from_cited, defaulted, missing. Do not paraphrase or invent a status."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "status",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

getFeasibilitySnapshot

Look up what can be built at a specific street address in Canada or the US. Returns the lot (area, width, depth), its zone and permitted uses, and the building envelope (height, storeys, site coverage, FSR, and front/rear/side/flanking setbacks) in one call. Use when someone asks what they can build, how tall, how close to the property line, how big their lot is, or what their property is zoned for. Do not use for questions that are not about a specific address — it resolves one address at a time and cannot search or compare. Every envelope value carries a `status`. A null value with status `no_limit_in_bylaw` means the bylaw sets no limit; a null value with status `not_extracted` means the value is unknown to Bucky; a null value with status `site_specific_schedule` means the zone is governed by a per-site schedule, not a zone table. Never report `not_extracted` or `site_specific_schedule` as "no limit" or as zero.

Parameters3

address	string	required	Street address to analyse, e.g. "4170 Sophia St, Vancouver BC".
source	string	required	Which question the caller is answering. Used for attribution and to pick the link back; the payload is the same either way.
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 3,
      "maxLength": 500,
      "description": "Street address to analyse, e.g. \"4170 Sophia St, Vancouver BC\"."
    },
    "source": {
      "default": "full",
      "description": "Which question the caller is answering. Used for attribution and to pick the link back; the payload is the same either way.",
      "type": "string",
      "enum": [
        "zoning_lookup",
        "lot_dimensions",
        "setback_lookup",
        "height_limit_lookup",
        "full"
      ]
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "address",
    "source",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

runFeasibilityAnalysis

Enqueue a fresh deterministic analysis run for a saved project. Pass `projectId`, or `project` with the name the user said; with neither, the result lists their projects and nothing is queued. Returns immediately with `agentStatus` (`queued`, `running`, `current`, `failed`, or `none`) and a receipt id; does not block on completion. Irreversible: a queued run cannot be un-queued from MCP. Re-check with `getProjectContext`, but no more than once every 15 seconds — it is a multi-query bundle, not a status endpoint.

Parameters3

projectId	string	optional	Project UUID. Omit if you pass `project`.
project	string	optional	Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "description": "Project UUID. Omit if you pass `project`.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "project": {
      "description": "Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

getProjectContext

Load one project with analysis envelope, compact agentStatus, document summaries, evidence summaries, the project memory digest, and external_ref when the project was imported from another system. You do not need a UUID: pass `project` with the name the user said, or call with neither and the result lists their projects to choose from. Use before composing reports or after scheduling analysis.

Parameters5

projectId	string	optional	Project UUID. Omit if you pass `project`.
project	string	optional	Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.
documentsLimit	integer	required
evidenceLimit	integer	required
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "description": "Project UUID. Omit if you pass `project`.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "project": {
      "description": "Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "documentsLimit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "evidenceLimit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "documentsLimit",
    "evidenceLimit",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

saveToProject

Create a new project from a site (`create`), attach lots (`attach_parcels`, using lot.parcelExternalId from getFeasibilitySnapshot), or attach a knowledge reference (`attach_reference`). On `create`, pass `address`, or `lat` and `lng` from getFeasibilitySnapshot when you already have them: coordinates resolve the project to a city, and an address alone is geocoded server-side. Check `geography` on the result — `resolved: false` means the project has no city context and feasibility analysis will have nothing to resolve against, and `coordinateSource: "geocoded"` means the server picked the point, so confirm it is the right site. preview=true returns the field-level diff and writes nothing. A write returns a receipt. Not reversible on this surface: MCP cannot archive a project, detach a parcel, or detach a reference. attach_parcels and attach_reference take `projectId`, or `project` with the name the user said; with neither, the result lists their projects and nothing is attached. Create accepts idempotencyKey and externalRef (`<system>:<id>`, e.g. `notion:<page-id>`) so an imported project can be looked up later.

Parameters15

action	string	required	create: new project from a site. attach_parcels: attach lots to an existing project (use lot.parcelExternalId from getFeasibilitySnapshot). attach_reference: link a knowledge section to an existing project.
name	string	optional
address	string	optional	Street address of the site. On `create` this is geocoded server-side when lat/lng are not supplied, and is what gets recorded as the project address.
lat	number	optional	Latitude from getFeasibilitySnapshot. Supplied coordinates are never re-geocoded.
lng	number	optional	Longitude from getFeasibilitySnapshot.
projectId	string	optional	Existing project UUID. Required by attach_parcels and attach_reference unless you pass `project`; ignored by create.
project	string	optional	Project name to match instead of a UUID, for attach_parcels and attach_reference. Matching more than one lists the candidates instead of guessing. Ignored by create.
sectionUuid	string	optional
parcelExternalIds	array	optional	Source parcel ids to attach. Copy lot.parcelExternalId from getFeasibilitySnapshot, or from bucky parcels search.
role	string	optional	build is the lot being developed; context is surrounding land. Default build.
radiusM	integer	optional	Search half-width in metres when resolving parcel ids. Default 150.
idempotencyKey	string	optional
externalRef	string	optional	Provenance of an imported project. Canonical form is `<system>:<id>` (e.g. `notion:<page-id>`). Unique per creator when set. Returned on getProjectContext. Distinct from idempotencyKey.
preview	boolean	required	When true, return the field-level diff and write nothing.
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "create",
        "attach_reference",
        "attach_parcels"
      ],
      "description": "create: new project from a site. attach_parcels: attach lots to an existing project (use lot.parcelExternalId from getFeasibilitySnapshot). attach_reference: link a knowledge section to an existing project."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "address": {
      "description": "Street address of the site. On `create` this is geocoded server-side when lat/lng are not supplied, and is what gets recorded as the project address.",
      "type": "string",
      "minLength": 3,
      "maxLength": 200
    },
    "lat": {
      "description": "Latitude from getFeasibilitySnapshot. Supplied coordinates are never re-geocoded.",
      "type": "number"
    },
    "lng": {
      "description": "Longitude from getFeasibilitySnapshot.",
      "type": "number"
    },
    "projectId": {
      "description": "Existing project UUID. Required by attach_parcels and attach_reference unless you pass `project`; ignored by create.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "project": {
      "description": "Project name to match instead of a UUID, for attach_parcels and attach_reference. Matching more than one lists the candidates instead of guessing. Ignored by create.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "sectionUuid": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "parcelExternalIds": {
      "description": "Source parcel ids to attach. Copy lot.parcelExternalId from getFeasibilitySnapshot, or from bucky parcels search.",
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 160
      }
    },
    "role": {
      "description": "build is the lot being developed; context is surrounding land. Default build.",
      "type": "string",
      "enum": [
        "build",
        "context"
      ]
    },
    "radiusM": {
      "description": "Search half-width in metres when resolving parcel ids. Default 150.",
      "type": "integer",
      "minimum": 10,
      "maximum": 400
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128
    },
    "externalRef": {
      "description": "Provenance of an imported project. Canonical form is `<system>:<id>` (e.g. `notion:<page-id>`). Unique per creator when set. Returned on getProjectContext. Distinct from idempotencyKey.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "preview": {
      "default": false,
      "description": "When true, return the field-level diff and write nothing.",
      "type": "boolean"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "action",
    "preview",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

updateProject

Patch project metadata (name, lifecycle status, externalRef). Pass `projectId`, or `project` with the name the user said; with neither, the result lists their projects and nothing is written. preview=true returns the field-level diff and writes nothing. A write returns a receipt; undoOperationId restores the captured prior fields. Does not archive or delete.

Parameters8

projectId	string	optional	Project UUID. Omit if you pass `project`.
project	string	optional	Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.
name	string	optional
lifecycleStatus	string	optional
externalRef	any	optional	Provenance of an imported project. Canonical form is `<system>:<id>` (e.g. `notion:<page-id>`). Unique per creator when set. Pass null to clear.
preview	boolean	required	When true, return the field-level diff and write nothing. Combined with undoOperationId, returns the stored receipt.
undoOperationId	string	optional	Receipt id from a prior updateProject write. Restores the captured prior fields. With preview=true, inspects the receipt instead.
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "description": "Project UUID. Omit if you pass `project`.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "project": {
      "description": "Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "lifecycleStatus": {
      "type": "string"
    },
    "externalRef": {
      "description": "Provenance of an imported project. Canonical form is `<system>:<id>` (e.g. `notion:<page-id>`). Unique per creator when set. Pass null to clear.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "preview": {
      "default": false,
      "description": "When true, return the field-level diff and write nothing. Combined with undoOperationId, returns the stored receipt.",
      "type": "boolean"
    },
    "undoOperationId": {
      "description": "Receipt id from a prior updateProject write. Restores the captured prior fields. With preview=true, inspects the receipt instead.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "preview",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

setProjectMapListing

Put a project on the public Bucky map, or take it off. Pass `projectId`, or `project` with the name the user said; with neither, the result lists their projects and nothing is published. Listing publishes the build-lot centroid, the project name, its zone category, typology and lifecycle status to anyone — signed in or not. Nothing else about the project is published. The project must have a build lot with a centroid; a project that has only an address and no attached build parcel cannot be pinned. Ask the human before listing a site that is not already public knowledge. A client, a friend, or a private residence is theirs to publish, not yours. preview=true returns the current state, the exact pin that would be published, and any privacy warning, and writes nothing. Unlisting removes the pin but does not un-share anything already collected while it was public.

Parameters5

projectId	string	optional	Project UUID. Omit if you pass `project`.
project	string	optional	Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.
listed	boolean	required	true lists the project on the public map; false removes it. Listing publishes the build-lot centroid and the project name to anyone, signed in or not.
preview	boolean	required	When true, return the current listing state, the pin that would be published, and any privacy warning, and write nothing.
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "description": "Project UUID. Omit if you pass `project`.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "project": {
      "description": "Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "listed": {
      "type": "boolean",
      "description": "true lists the project on the public map; false removes it. Listing publishes the build-lot centroid and the project name to anyone, signed in or not."
    },
    "preview": {
      "default": false,
      "description": "When true, return the current listing state, the pin that would be published, and any privacy warning, and write nothing.",
      "type": "boolean"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "listed",
    "preview",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

produceProjectReport

Pass `projectId`, or `project` with the name the user said; with neither, the result lists their projects and no meter is spent. Compose a grounded report plan, optionally preview without spending export meter (`preview=true`), or confirm export (`confirm=true`) to save the plan and return a short-lived signed download URL plus a receipt — never PDF bytes in the tool result. Confirm spends `records.exports` and is irreversible.

Parameters9

projectId	string	optional	Project UUID. Omit if you pass `project`.
project	string	optional	Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.
audience	string	required
detail	string	required
request	string	optional
preview	boolean	required	When true, compose only — no export meter spend and no download URL.
confirm	boolean	required	When true, compose (if needed), save, export PDF, and return a download URL. Required when preview is false. Spends records.exports and cannot be undone.
planName	string	optional
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "description": "Project UUID. Omit if you pass `project`.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "project": {
      "description": "Project name to match, when you do not have the UUID. Case-insensitive; an exact name wins over a partial one. Matching more than one lists the candidates instead of guessing.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "audience": {
      "default": "owner",
      "type": "string",
      "enum": [
        "investor",
        "owner",
        "board",
        "resident"
      ]
    },
    "detail": {
      "default": "detailed",
      "type": "string",
      "enum": [
        "brief",
        "detailed"
      ]
    },
    "request": {
      "type": "string",
      "minLength": 3,
      "maxLength": 4000
    },
    "preview": {
      "default": false,
      "description": "When true, compose only — no export meter spend and no download URL.",
      "type": "boolean"
    },
    "confirm": {
      "default": false,
      "description": "When true, compose (if needed), save, export PDF, and return a download URL. Required when preview is false. Spends records.exports and cannot be undone.",
      "type": "boolean"
    },
    "planName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "audience",
    "detail",
    "preview",
    "confirm",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

submitBuckyFeedback

Open a human-reviewed feedback form and submit it to the Bucky product team. Call only when the user explicitly asks to send feedback, report a problem, suggest an improvement, or praise something. The server asks the MCP client to show the form; nothing is saved unless the human accepts it. Do not use for silent agent self-reporting.

Parameters3

submissionId	string	optional	Optional. A UUID for this submission; generated server-side when omitted. Pass the same UUID when retrying this exact feedback so it is not recorded twice.
affectedToolName	string	optional	Tool the user is commenting on, when already known
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "submissionId": {
      "description": "Optional. A UUID for this submission; generated server-side when omitted. Pass the same UUID when retrying this exact feedback so it is not recorded twice.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "affectedToolName": {
      "description": "Tool the user is commenting on, when already known",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

previewSiteCoverage

Free preview, no sign-in needed. For one street address in Canada or the US, it says whether Bucky covers the place and which zoning facts it holds for the lot (lot boundary, zone, height, density, setbacks, permitted uses, overlays, parking): found, partly on file, or not on file. It returns no values: no zone code, heights, setbacks or areas. The lot outline is a shape with no scale. Use it when the user is not signed in and asks what they can build at an address. For the numbers, call getFeasibilitySnapshot. That call asks the user to sign in.

Parameters2

address	string	required	Street address to analyse, e.g. "4170 Sophia St, Vancouver BC".
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "minLength": 3,
      "maxLength": 500,
      "description": "Street address to analyse, e.g. \"4170 Sophia St, Vancouver BC\"."
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "address",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

uiGetAnalysisStatus

Return only the analysis `agentStatus` for a project. Cheap enough to poll. Used by the Bucky app view; the model should call getProjectContext instead.

Parameters2

projectId	string	required
context	string	required	Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization."

Raw schema

{
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "context": {
      "type": "string",
      "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
    }
  },
  "required": [
    "projectId",
    "context"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

README.md3 KBView on GitHub

Bucky

Cited site feasibility and pre-development project workflows for Canada and the United States, as a plugin and a hosted MCP server.

Give it a street address and it returns the lot, the zone, the permitted uses, and the material envelope — setbacks, height, coverage, density — with each value carrying its own provenance. A setback the bylaw does not limit and a setback Bucky could not extract are different answers, and they stay different.

code

https://buckybuild.com/api/mcp

Docs: https://docs.buckybuild.com/docs/mcp

Install

Claude Code

/plugin marketplace add markbucky/bucky-plugin
/plugin install bucky@bucky

Or the connector alone, without the skills:

claude mcp add --transport http bucky https://buckybuild.com/api/mcp

Claude (web and desktop)

Settings → Connectors → Add custom connector, and paste the URL above. Needs a paid plan.

Cursor

Add Bucky to Cursor

VS Code

Add Bucky to VS Code

Codex

~/.codex/config.toml:

toml

[mcp_servers.bucky]
url = "https://buckybuild.com/api/mcp"

Then codex mcp login bucky.

ChatGPT and Grok

Add as a custom connector in ChatGPT's developer-mode Connectors settings, or at grok.com/connectors → New Connector → Custom.

Anything else

Any Streamable HTTP client takes the same object:

json

{ "type": "http", "url": "https://buckybuild.com/api/mcp" }

What is in the plugin

Four skills, and one MCP connector:

Skill	For
`site-feasibility`	Zoning, lot, setback, and height lookup for one address
`save-and-analyze-project`	Save a site, attach its parcel, run analysis
`project-report`	Prepare and export a cited report
`explain-feasibility-status`	Interpret a coverage or provenance status

Authentication

Two tools work with no account, so you can confirm the connection before signing in: getBuckyMcpGuide and explainFeasibilityStatus.

Everything else uses Bucky's OAuth browser flow. You never paste a token. Connected apps are listed at Settings → Connected apps, with what each can do and when it was last used; disconnecting takes effect on the next request rather than whenever a token expires.

Account-scoped tools need a Professional plan or prepaid developer credit.

Limits

Coverage varies by jurisdiction. Results are preliminary decision support — not a permit, an appraisal, a guarantee, or a legal, engineering, or architectural opinion.

Contributing

This repo is a mirror. The source of truth is Bucky's monorepo, and changes made here are overwritten on the next sync. Open an issue rather than a pull request, or send feedback through the submitBuckyFeedback tool — it goes to a human.

License

Apache-2.0. See LICENSE.

Install

Tools (12)

getBuckyMcpGuideexplainFeasibilityStatusgetFeasibilitySnapshotrunFeasibilityAnalysisgetProjectContextsaveToProjectupdateProjectsetProjectMapListing

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://buckybuild.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "bucky": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://buckybuild.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

com.buckybuild/bucky (Model Context Protocol Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

getBuckyMcpGuide

explainFeasibilityStatus

getFeasibilitySnapshot

runFeasibilityAnalysis

getProjectContext

saveToProject

updateProject

setProjectMapListing

produceProjectReport

submitBuckyFeedback

previewSiteCoverage

uiGetAnalysisStatus

Bucky

Install

Claude Code

Claude (web and desktop)

Cursor

VS Code

Codex

ChatGPT and Grok

Anything else

What is in the plugin

Authentication

Limits

Contributing

License

Install

Remote endpoint

Related servers