(206) 410-5100Click to Call
Kolmo Logo
Developer Docs

Kolmo MCP Server

Integrate Kolmo's construction data — estimates, permits, ROI, reviews, and more — directly into any AI assistant or agent via the Model Context Protocol.

Transport: Streamable HTTP
Auth: None (public)
Protocol: MCP 2024-11-05
20 tools

Quick Start

Step 1

Point your client

Add the server URL to your AI client config. No API key needed.
Step 2

Initialize

Send an initialize request. The server returns capabilities and the full tool list.
Step 3

Call tools

Use tools/call with any of the 20 available tools.

Endpoint

MCP Endpoint
https://www.kolmo.io/mcp
Transport
Streamable HTTP (POST)
Authentication
None — fully public

Client Setup

Claude Desktop / Claude Code

Add to your claude_desktop_config.json or .mcp.json:

claude_desktop_config.json
{
  "mcpServers": {
    "kolmo": {
      "url": "https://www.kolmo.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Cursor / Windsurf

Add to your project's .cursor/mcp.json or equivalent:

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

Protocol Reference

The server uses JSON-RPC 2.0 over HTTP POST. Every request must include Content-Type: application/json. Sessions are optional — the server is stateless for tool calls.

1. Initialize (optional but recommended)

shell
curl -X POST https://www.kolmo.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "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" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_business_info",
      "arguments": {}
    }
  }'

Tools Reference

Business

get_business_info

Company details, contact info, hours, service area, specializations

params: none

Services

list_services

All residential remodeling services with slugs and descriptions

params: search?, limit?, offset?

get_service

Full details for a specific service by slug

params: slug

list_commercial_services

Commercial construction services, filterable by category

params: category?, limit?, offset?

Projects

list_projects

Completed projects with before/after photos and locations

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

get_project

Full project details including images and testimonial

params: slug

Estimates & Materials

list_project_types

Available project types supported by the estimator

params: none

get_material_options

Material tiers and options for a given project type

params: projectType

get_material_catalog

Full material catalog with pricing for a project type

params: projectType

get_estimate

Instant cost estimate based on project specs

params: projectType, ...specs

Market Intelligence

get_project_roi

Expected ROI for a renovation type in a Seattle neighborhood

params: projectType, neighborhood?

get_weather_window

Best scheduling windows based on Seattle weather patterns

params: projectType, month?

check_permit_requirements

Seattle SDCI permit requirements and estimated fees

params: projectType, scope?

get_neighborhood_project_activity

Recent renovation activity trends by neighborhood

params: neighborhood?

Trust & Financing

check_contractor_license_status

Verify Kolmo's WA State contractor license status

params: none

get_financing_options

Available financing plans and eligibility ranges

params: projectCost?

list_reviews

Customer reviews with ratings and project types

params: limit?, offset?

Content

list_blog_posts

Published articles on remodeling, costs, and tips

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

get_blog_post

Full article content by slug

params: slug

Contact

submit_contact_request

Submit a quote request or project inquiry

params: name, email, message, projectType?

Auth & Rate Limits

Authentication: None required. All tools are publicly accessible.

Rate limiting: Standard rate limits apply per IP. For high-volume integrations, contact [email protected].

Sessions: The server supports optional session IDs via the Mcp-Session-Id header for clients that need stateful connections.

CORS: Enabled for all origins. The endpoint is safe to call from browser environments with proper MCP transport semantics.

MCP Registries

Find this server in public MCP directories

  • Official MCP Registry — io.kolmo.www/kolmo-mcp-server
  • Glama — server ID spmyladq4n
  • MCP.so — slug kolmo-construction

Questions or integration issues?

Reach out and we'll help you get connected.

Contact us