kolmo-mcp-server

# Kolmo Construction MCP Server

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=kolmo&config=eyJ1cmwiOiJodHRwczovL3d3dy5rb2xtby5pby9tY3AifQ==)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=kolmo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.kolmo.io%2Fmcp%22%7D)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=kolmo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.kolmo.io%2Fmcp%22%7D&quality=insiders)
[![Glama score](https://glama.ai/mcp/servers/Kolmo-Construction/kolmo-mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/Kolmo-Construction/kolmo-mcp-server)
[![MCP Marketplace](https://img.shields.io/badge/MCP%20Marketplace-Indexed-blueviolet)](https://getlulu.dev/mcps)

Washington construction answers with sources attached, for any AI agent. A live, remote
[Model Context Protocol](https://modelcontextprotocol.io) server published by
[Kolmo Construction](https://www.kolmo.io), a Washington-registered general contractor:

- **Permit rules** for 80+ King, Pierce and Snohomish County jurisdictions, each cited to the
  city source with a verification date and freshness telemetry
- **Address-first parcel lookup** — zoning, setbacks and overlays from county GIS
- **Permit fee estimates** that walk the jurisdiction's fee schedule
- **Grounded permit Q&A** for a specific address
- **L&I license, bond and insurance checks** for ANY Washington contractor
- **Seattle-area cost estimates**, ROI and financing for 13 project types

No account, no API key, same URL for every user. Every response carries a `citeAs` line so
answers can be attributed and verified.

**Endpoint:** `https://www.kolmo.io/mcp`
**Transport:** Streamable HTTP (JSON-RPC 2.0), CORS open
**Discovery:** `https://www.kolmo.io/.well-known/mcp.json`
**Docs:** https://www.kolmo.io/developers
**Server version:** `1.5.0`

## Connect

```bash
# Claude Code
claude mcp add --transport http kolmo https://www.kolmo.io/mcp

# Gemini CLI
gemini mcp add --transport http kolmo https://www.kolmo.io/mcp
```

| Client | How |
|--------|-----|
| **Claude.ai / Claude Desktop** | Settings → Connectors → *Add custom connector* → name `Kolmo`, URL above, no auth |
| **ChatGPT** | Settings → Connectors → Advanced → *Developer mode* → Create → name `Kolmo`, URL above, auth: none |
| **Cursor** | Click *Add to Cursor* above, or `.cursor/mcp.json`: `{"mcpServers":{"kolmo":{"url":"https://www.kolmo.io/mcp"}}}` |
| **VS Code (Copilot)** | Click *Install in VS Code* above, or `.vscode/mcp.json`: `{"servers":{"kolmo":{"type":"http","url":"https://www.kolmo.io/mcp"}}}` |
| **Windsurf** | `~/.codeium/windsurf/mcp_config.json`: `{"mcpServers":{"kolmo":{"serverUrl":"https://www.kolmo.io/mcp"}}}` |
| **Gemini CLI** | `~/.gemini/settings.json`: `{"mcpServers":{"kolmo":{"httpUrl":"https://www.kolmo.io/mcp"}}}` |
| **Claude Code (project)** | `.mcp.json`: `{"mcpServers":{"kolmo":{"type":"http","url":"https://www.kolmo.io/mcp"}}}` |
| **stdio-only clients** | `npx -y mcp-remote https://www.kolmo.io/mcp`, or `proxy.mjs` in this repo |

## What to ask it

| Ask | Tool |
|-----|------|
| Do I need a permit for X in \<city\>? | `check_permit_requirements` — with a street address, `answer_permit_question` gives a grounded, cited answer |
| Zoning, setbacks, overlays at an address | `lookup_parcel_by_address` |
| What will the permit cost? | `estimate_permit_fee` |
| Is \<contractor\> licensed, bonded, insured? | `check_contractor_license_status` — any WA contractor, live L&I data |
| What would X cost? | `get_estimate` (`list_project_types` names the fields, `get_material_options` the material IDs) |
| Is the remodel worth it / how to pay for it | `get_project_roi` · `get_financing_options` |
| Who is Kolmo, show me the work | `get_business_info` · `list_reviews` · `list_projects` |
| Anything else | `search_content` |
| Ready to hire | `submit_contact_request` (`dryRun: true` previews without sending) |

<!-- generated:tools:start -->
## Tools (36)

| Tool | Description |
|------|-------------|
| `get_business_info` | Get Kolmo Construction company information: contact details, hours, service area, specializations, and tools. |
| `list_services` | List all residential remodeling services with slugs, descriptions, and page URLs. |
| `get_service` | Get full details for a specific residential service by its slug. |
| `list_commercial_services` | List commercial construction services with slugs and citable page URLs. |
| `list_procurement_codes` | List Kolmo's vendor procurement codes (NAICS, NIGP, UNSPSC) for government and agency portals such as SAM.gov, WA WEBS, OpenGov, MRSC, King County, and City of Seattle. |
| `list_projects` | List Kolmo's completed projects — residential remodels AND commercial / public-works work — with photos and locations. |
| `get_project` | Get full details for a specific project by its slug, including before/after images and testimonial. |
| `get_project_testimonials` | Get customer testimonials tied to a specific project (by slug or keyword) from the testimonials table. |
| `list_blog_posts` | List published blog posts about home remodeling, renovation costs, and construction tips. |
| `get_blog_post` | Get the full markdown content of a blog post by its slug. |
| `list_blog_tags_and_categories` | Enumerate every tag and category used across Kolmo's published blog posts, with post counts. |
| `submit_contact_request` | Submit a contact or quote request to Kolmo Construction on behalf of a user. |
| `list_project_types` | List all 13 supported calculator project types with their required input fields and descriptions. |
| `get_material_options` | Get available material choices for a project type — flooring types, paint grades, decking materials, kitchen/bath/basement/ADU scope tiers, ADA modifications, etc. |
| `get_estimate` | Calculate a Seattle-area cost estimate. |
| `list_reviews` | List customer reviews and testimonials for Kolmo Construction. |
| `check_permit_requirements` | Check whether a residential construction project in King/Pierce/Snohomish counties requires a permit. |
| `get_permit_rule_details` | Enumerate permit rules with full detail — timeline, fee model, inspection sequence, submittals, required contractor specialties. |
| `match_contractor_to_permit` | Cross-reference a WA contractor's L&I license specialty against a permit's required specialties. |
| `estimate_permit_fee` | Estimate the permit fee for a residential project based on jurisdiction, project type, and project valuation. |
| `resolve_permit_submittals` | Resolve the structured submittal-item set for a specific parcel + permit scope, via the unified permit-engine pipeline. |
| `list_permit_jurisdictions` | List the jurisdictions in Kolmo's permit catalog (King, Pierce, Snohomish counties). |
| `lookup_parcel_by_address` | Address-first parcel lookup powering the /permits experience. |
| `parse_project_description` | Parse a homeowner's natural-language project description into structured permit-relevant fields: projectType (kitchen\|bathroom\|deck\|adu\|fence\|...), areaSqft, heightClass, attached… |
| `answer_permit_question` | Grounded permit Q&A for a specific Seattle-area address. |
| `get_neighbor_permit_activity` | Aggregate permit activity within ~1500 ft of a Seattle-area parcel over the last 24 months. |
| `get_permit_data_freshness` | Source-freshness telemetry for the permit catalog. |
| `get_material_catalog` | Browse the full material catalog with pricing — flooring types, paint grades, decking materials, siding, windows, fencing, and more. |
| `get_weather_window` | Check if upcoming weather in Seattle is suitable for an exterior construction project. |
| `get_neighborhood_project_activity` | See what remodeling projects Kolmo Construction has completed in a specific Seattle neighborhood or city. |
| `check_service_area_coverage` | Check whether Kolmo services a given city, neighborhood, or ZIP in the Seattle / King County area. |
| `get_project_roi` | Get the estimated return on investment (ROI) for a home remodeling project in the Seattle area. |
| `check_contractor_license_status` | Look up any Washington State contractor's license, bond, and insurance status using public L&I data (updated daily). |
| `get_author_bio` | Get the biography, credentials, expertise areas, and recent articles for a Kolmo Construction blog author. |
| `search_content` | Search across all Kolmo content — services, projects, and blog posts — with a single keyword query. |
| `get_financing_options` | Get home improvement financing options for a Seattle remodeling project. |
<!-- generated:tools:end -->

<!-- generated:prompts:start -->
## Workflow prompts (6)

Guided multi-step workflows, served via `prompts/list` / `prompts/get`:

- `estimate_project` (`project_type`, `rough_size`?, `budget_range`?) — Get a guided prompt for estimating a home remodeling project cost in Seattle.
- `check_permit_needs` (`project_type`, `location`?) — Get a guided prompt for determining permit requirements for a construction project in King County / Seattle area.
- `plan_renovation` (`project_type`, `budget`?, `timeline`?) — Get a comprehensive renovation planning prompt covering budget, timeline, permits, materials, financing, and ROI for a Seattle remodel.
- `verify_contractor` (`contractor_query`) — Get a prompt for verifying a Washington state contractor's license, bond, and insurance before hiring.
- `compare_financing` (`budget`, `credit_profile`?) — Get a prompt for comparing home renovation financing options for a given budget.
- `explore_neighborhood` (`neighborhood`, `project_type`?) —