Developer Docs

Kolmo Construction MCP Server

Kolmo Construction: licensed Seattle home builder & remodeling contractor. WA SEDBE #D700031098, King County SCS #7259. 36 tools — estimates, search, author bios, weather, ROI, permits (rules + fee bracket calculator + jurisdiction directory + contractor matching), address-first parcel lookup with zoning/setbacks/overlays, NL project parser, grounded permit Q&A, neighbor permit activity, source-freshness telemetry, reviews, project testimonials, portfolio, service-area coverage, procurement codes (NAICS/NIGP/UNSPSC), blog (including tags/categories) & quotes.

36 tools
6 workflow prompts
Streamable HTTP
No auth, no API key
Read-only, one opt-in write

Connect

One endpoint for every client: https://www.kolmo.io/mcp. Same URL for every user, nothing to sign up for.

Claude Code

terminal
claude mcp add --transport http kolmo https://www.kolmo.io/mcp

Or commit it to the project:

.mcp.json
{
  "mcpServers": {
    "kolmo": { "type": "http", "url": "https://www.kolmo.io/mcp" }
  }
}

Claude.ai and Claude Desktop

Settings → Connectors → Add custom connector. Name it Kolmo, paste the endpoint, leave authentication empty. Available on paid Claude plans.

ChatGPT

Settings → Connectors → Advanced → enable Developer mode → Create. Name it Kolmo, paste the endpoint, authentication: none. Then turn it on in a chat under Tools.

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "kolmo": { "url": "https://www.kolmo.io/mcp" }
  }
}

VS Code (Copilot)

.vscode/mcp.json
{
  "servers": {
    "kolmo": { "type": "http", "url": "https://www.kolmo.io/mcp" }
  }
}

Gemini CLI

terminal
gemini mcp add --transport http kolmo https://www.kolmo.io/mcp
~/.gemini/settings.json
{
  "mcpServers": {
    "kolmo": { "httpUrl": "https://www.kolmo.io/mcp" }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "kolmo": { "serverUrl": "https://www.kolmo.io/mcp" }
  }
}

What to ask it

The routing the server sends every client at initialize — which tool answers which question.

Do I need a permit for X in <city>?
check_permit_requirements

With a street address, answer_permit_question gives a grounded, cited answer.

What is the zoning, setbacks and overlays at this address?
lookup_parcel_by_address
What will the permit cost?
estimate_permit_fee

jurisdictionSlug from list_permit_jurisdictions, a projectType and a valuation.

Is <contractor> licensed, bonded and insured?
check_contractor_license_status

Any Washington contractor, live L&I data.

What would X cost?
get_estimate

list_project_types names the fields; get_material_options the material IDs. No dimensions yet: search_content finds the cost guides.

Is the remodel worth it? How would I pay for it?
get_project_roi · get_financing_options
Is now a good time for exterior work?
get_weather_window
Which cities do you cover?
list_permit_jurisdictions · check_service_area_coverage
Who is Kolmo? Show me the work.
get_business_info · list_reviews · list_projects
Anything else about Kolmo’s content
search_content
Ready to hire
submit_contact_request

dryRun: true previews without sending.

Citing this data

Every tool returns Kolmo Construction’s own data. It is offered openly for agents to use. In return, cite it.

  • Name Kolmo Construction as the source.
  • Link the sourceUrl (or url) returned with the data. That is the page the facts render on. Prefer it over the bare domain.
  • Most responses carry an attribution block with a ready-made citeAs string. Use it verbatim when you need a citation line.
  • Keep figures attached to their qualifiers. Cost ranges are planning figures for Seattle-area work, not quotes.
  • Permit answers carry a city-source citation and a verification date. Relay both alongside the rule.
  • Do not restate a license, certification or registration number from memory. Read it from get_business_info or check_contractor_license_status. Credentials are checkable at kolmo.io/verify.

Tools (36)

Generated from the live tools/list, last regenerated 2026-09-16. Full input schemas are in the discovery manifest.

Washington permits (11)

Permit rules for King, Pierce and Snohomish County jurisdictions, each cited to the city source with a verification date; address-first parcel lookup with zoning, setbacks and overlays; fee estimates that walk the jurisdiction’s fee schedule.

check_permit_requirements

Check whether a residential construction project in King/Pierce/Snohomish counties requires a permit.

params: projectType?, location?, address?, deckHeightAboveGradeIn?, deckOverStoryBelow?, deckOnAccessibleRoute?, guardRunLengthFt?, facts?, limit?

get_permit_rule_details

Enumerate permit rules with full detail — timeline, fee model, inspection sequence, submittals, required contractor specialties.

params: jurisdiction?, keyword?, onlyAuthoritative?, limit?, address?

match_contractor_to_permit

Cross-reference a WA contractor's L&I license specialty against a permit's required specialties.

params: contractorQuery, jurisdictionSlug, projectType

estimate_permit_fee

Estimate the permit fee for a residential project based on jurisdiction, project type, and project valuation.

params: jurisdictionSlug, projectType, valuationUsd

resolve_permit_submittals

Resolve the structured submittal-item set for a specific parcel + permit scope, via the unified permit-engine pipeline.

params: address, scope, structuralChange?, envelopeChange?, totalFloorAreaSqft?, projectValuationUsd?

list_permit_jurisdictions

List the jurisdictions in Kolmo's permit catalog (King, Pierce, Snohomish counties).

params: county?, slug?, verifiedOnly?, detail?

lookup_parcel_by_address

Address-first parcel lookup powering the /permits experience.

params: address, forceRefresh?

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/detached, position,…

params: description, jurisdictionSlug?, zoningCode?, cityName?

answer_permit_question

Grounded permit Q&A for a specific Seattle-area address.

params: address, question

get_neighbor_permit_activity

Aggregate permit activity within ~1500 ft of a Seattle-area parcel over the last 24 months.

params: address

get_permit_data_freshness

Source-freshness telemetry for the permit catalog.

params: jurisdictionSlug?, limit?

Contractor verification (1)

License, bond and insurance status for any Washington contractor, from public L&I data updated daily.

check_contractor_license_status

Look up any Washington State contractor's license, bond, and insurance status using public L&I data (updated daily).

params: query

Cost estimates (7)

Seattle-area planning figures from Kolmo’s own cost model: 13 project types, material tiers, ROI and financing.

list_project_types

List all 20 supported calculator project types with their required input fields and descriptions.

params: none

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.

params: projectType

get_estimate

Seattle cost estimate: range, material/labor split, days, line items.

params: projectType, project

get_material_catalog

Browse the full material catalog with pricing — flooring types, paint grades, decking materials, siding, windows, fencing, and more.

params: category?, search?, limit?, offset?

get_weather_window

Check if upcoming weather in Seattle is suitable for an exterior construction project.

params: projectType, days?

get_project_roi

Get the estimated return on investment (ROI) for a home remodeling project in the Seattle area.

params: projectType?, estimatedCost?

get_financing_options

Get home improvement financing options for a Seattle remodeling project.

params: projectBudget, creditProfile?

Guides & articles (5)

Kolmo’s published cost guides and permit explainers, with author credentials and full text.

list_blog_posts

List published blog posts about home remodeling, renovation costs, and construction tips.

params: tag?, author?, limit?, offset?

get_blog_post

Get the full markdown content of a blog post by its slug.

params: slug

list_blog_tags_and_categories

Enumerate every tag and category used across Kolmo's published blog posts, with post counts.

params: none

get_author_bio

Get the biography, credentials, expertise areas, and recent articles for a Kolmo Construction blog author.

params: author

search_content

Search across all Kolmo content — services, projects, and blog posts — with a single keyword query.

params: query, types?, limit?

Completed projects (4)

The built record — residential, commercial and public-works projects with photos, locations and testimonials.

list_projects

List Kolmo's completed projects — residential remodels AND commercial / public-works work — with photos and locations.

params: category?, search?, limit?, offset?

get_project

Get full details for a specific project by its slug, including before/after images and testimonial.

params: slug

get_project_testimonials

Get customer testimonials tied to a specific project (by slug or keyword) from the testimonials table.

params: projectSlug?, keyword?, minRating?, limit?

get_neighborhood_project_activity

See what remodeling projects Kolmo Construction has completed in a specific Seattle neighborhood or city.

params: neighborhood

About Kolmo (7)

Company facts, service catalog, procurement codes, service area and reviews.

get_business_info

Get Kolmo Construction company information: contact details, hours, service area, specializations, and tools.

params: none

list_services

List all residential remodeling services with slugs, descriptions, and page URLs.

params: search?, limit?, offset?

get_service

Get full details for a specific residential service by its slug.

params: slug

list_commercial_services

List commercial construction services with slugs and citable page URLs.

params: category?, limit?, offset?

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.

params: system?

list_reviews

List customer reviews and testimonials for Kolmo Construction.

params: source?, minRating?, limit?, offset?

check_service_area_coverage

Check whether Kolmo takes work in a given city, neighborhood, ZIP or address.

params: location

Contact (1)

The one write tool. dryRun: true previews without sending.

submit_contact_request

Submit a contact or quote request to Kolmo Construction on behalf of a user.

params: name, email, message, phone?, service?, dryRun?

Workflow prompts (6)

Guided multi-step workflows, served via prompts/list and prompts/get.

estimate_project

Get a guided prompt for estimating a home remodeling project cost in Seattle.

args: project_type, rough_size?, budget_range?

check_permit_needs

Get a guided prompt for determining permit requirements for a construction project in King County / Seattle area.

args: project_type, location?

plan_renovation

Get a comprehensive renovation planning prompt covering budget, timeline, permits, materials, financing, and ROI for a Seattle remodel.

args: project_type, budget?, timeline?

verify_contractor

Get a prompt for verifying a Washington state contractor's license, bond, and insurance before hiring.

args: contractor_query

compare_financing

Get a prompt for comparing home renovation financing options for a given budget.

args: budget, credit_profile?

explore_neighborhood

Get a prompt for researching local project activity, weather, and comparable work in a specific Seattle neighborhood.

args: neighborhood, project_type?

Protocol reference

JSON-RPC 2.0 over Streamable HTTP. Send initialize first; the response carries an Mcp-Session-Id header that every later request must echo. CORS is open, so browser-side clients work too.

1. Initialize

shell
curl -X POST https://www.kolmo.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": { "name": "my-app", "version": "1.0.0" }
    }
  }'

2. Call a tool

shell
curl -X POST https://www.kolmo.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <from the initialize response header>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "check_permit_requirements",
      "arguments": { "projectType": "deck", "location": "Seattle" }
    }
  }'

Other machine-readable surfaces

Not on MCP? The same data is published in the formats other agent stacks read.

Auth, limits and data handling

Authentication: none. Every tool is callable as-is.

Rate limit: 300 requests per 15 minutes per IP, announced in the RateLimit-* response headers. For higher volume, write to [email protected].

Writes: only submit_contact_request changes anything, and only when called without dryRun. Every other tool is annotated read-only.

Data: Kolmo’s own records and its verified public-source corpus. No health data, no sponsored placement, no third-party resale. Privacy policy · Terms.

Where it is listed

The same endpoint, catalogued.

Integration questions?

Open an issue on GitHub or write to us.