Koskamo

Contractors Near Me MCP

An MCP server that allows AI agents to search for licensed US contractors by trade or location, fetch detailed profiles and reviews, check availability, and submit leads or reviews. It provides tools for both general search and authenticated contractor profile management.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Contractors Near Me MCP logo, by ContractorsNearMe.aiVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-07Operated by ContractorsNearMe.ai
You need:tools marked "API key" need an `x-api-key` header
MCP endpoint (Streamable HTTP)
https://contractorsnearme.ai/api/mcp
Vendor documentation

What its tools do

14 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (10)

Can change data (4)

14 of 14 have a description · 14 of 14 declare behavior hints · 0 of 13 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to contractorsnearme.ai ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search for licensed contractors by trade and location
  • Fetch detailed contractor profiles and customer reviews
  • Submit service leads to the platform
  • Manage contractor directory profiles and bids

Source and maintenance

Vendor evidenceRegistry 1.2.0
mcp-registry: ai.contractorsnearme/contractors-near-me@1.2.0

Protocol and capabilities

Server
contractors-near-me 1.3.0
MCP protocol negotiated in check
2025-11-25
Tools
14 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

14 advertised

search_contractors — Search Contractors
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search active contractors by trade, place (ZIP, city, state or province), company name or service words, and geo radius. Uses the same matching, ranking (distance, Bayesian rating, review count, profile completeness) and duplicate merging as contractorsnearme.ai/search. is_verified is true only when the contractor's license passed a check against a state board record.

search_contractors input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1
    },
    "lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90
    },
    "lng": {
      "type": "number",
      "maximum": 180,
      "minimum": -180
    },
    "city": {
      "type": "string",
      "minLength": 1
    },
    "sort": {
      "enum": [
        "relevance",
        "distance",
        "rating",
        "reviews",
        "name"
      ],
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "exclusiveMinimum": 0
    },
    "state": {
      "type": "string",
      "maxLength": 40,
      "minLength": 2
    },
    "trade": {
      "type": "string",
      "minLength": 1
    },
    "location": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "accountType": {
      "enum": [
        "gc",
        "supplier",
        "subcontractor",
        "customer"
      ],
      "type": "string"
    },
    "customerOnly": {
      "type": "boolean"
    },
    "radius_miles": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "contractorCategory": {
      "enum": [
        "gc",
        "supplier",
        "subcontractor"
      ],
      "type": "string"
    }
  }
}
search_contractors annotations
{
  "readOnlyHint": true,
  "idempotentHint": true
}
get_contractor — Get Contractor Profile
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get detailed contractor profile by slug. Returns full profile including about text, contact info, and trade details. is_verified is true only when the contractor's license passed a check against a state board record.

get_contractor input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1
    }
  }
}
get_contractor annotations
{
  "readOnlyHint": true,
  "idempotentHint": true
}
get_reviews — Get Contractor Reviews
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get reviews for a contractor by slug. Returns review text, rating, reviewer name, and dates. Limited to 50 per request.

get_reviews input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "contractor_slug"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "contractor_slug": {
      "type": "string",
      "minLength": 1
    }
  }
}
get_reviews annotations
{
  "readOnlyHint": true,
  "idempotentHint": true
}
list_trades — List Trades
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get a list of all available trades/professions. Returns filtered list of contractor trades from the directory.

list_trades input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
list_trades annotations
{
  "readOnlyHint": true,
  "idempotentHint": true
}
submit_lead — Submit Lead
Advertised by the server during the last successful anonymous check.

Submit a lead to ContractorsNearMe. Requires API key authentication.

submit_lead input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "email",
    "message"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "phone": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "minLength": 10
    },
    "trade_slug": {
      "type": "string"
    },
    "contractor_slug": {
      "type": "string"
    }
  }
}
submit_lead annotations
{
  "readOnlyHint": false,
  "idempotentHint": false
}
submit_review — Submit Review
Advertised by the server during the last successful anonymous check.

Submit a review for a contractor. Requires API key authentication. Reviews are held for moderation before publishing.

submit_review input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "contractor_slug",
    "rating",
    "description",
    "reviewer_name"
  ],
  "properties": {
    "title": {
      "type": "string"
    },
    "rating": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1
    },
    "description": {
      "type": "string",
      "minLength": 20
    },
    "rating_value": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1
    },
    "reviewer_name": {
      "type": "string",
      "minLength": 2
    },
    "rating_quality": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1
    },
    "contractor_slug": {
      "type": "string",
      "minLength": 1
    },
    "rating_timeliness": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1
    },
    "rating_cleanliness": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1
    },
    "rating_communication": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1
    }
  }
}
submit_review annotations
{
  "readOnlyHint": false,
  "idempotentHint": false
}
get_my_leads — Get My Leads
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get leads submitted to the authenticated contractor's directory profile. Requires API key authentication. Returns lead name, email, phone, message, status, source, and created date.

get_my_leads input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "status": {
      "type": "string"
    }
  }
}
get_my_leads annotations
{
  "title": "Get My Leads",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
respond_to_lead — Respond to Lead
Advertised by the server during the last successful anonymous check.

Update the status of a lead owned by the authenticated contractor's directory profile, optionally adding a note. Requires API key authentication. Allowed statuses: new, contacted, qualified, converted, lost.

respond_to_lead input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "lead_id"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 2000
    },
    "status": {
      "enum": [
        "new",
        "contacted",
        "qualified",
        "converted",
        "lost"
      ],
      "type": "string"
    },
    "lead_id": {
      "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)$"
    }
  }
}
respond_to_lead annotations
{
  "title": "Respond to Lead",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
update_my_profile — Update My Profile
Advertised by the server during the last successful anonymous check.

Update the authenticated contractor's own directory profile. Requires API key authentication. Only the profile owned by the key's contractor can be updated.

update_my_profile input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dba": {
      "type": "string",
      "maxLength": 200
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "phone": {
      "type": "string",
      "maxLength": 40
    },
    "quote": {
      "type": "string",
      "maxLength": 300
    },
    "website": {
      "type": "string",
      "maxLength": 500
    },
    "about_text": {
      "type": "string",
      "maxLength": 5000
    },
    "company_name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "company_size": {
      "type": "string",
      "maxLength": 100
    },
    "license_number": {
      "type": "string",
      "maxLength": 100
    },
    "year_established": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1800
    }
  }
}
update_my_profile annotations
{
  "title": "Update My Profile",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_itbs — Search ITBs
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search public invitations to bid (ITBs) on the projects board. Returns open project title, description, budget range, location, and created date. Public read, no API key required.

search_itbs input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 100
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "state_code": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2
    }
  }
}
search_itbs annotations
{
  "title": "Search ITBs",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_itb — Get ITB
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get a single public invitation to bid (ITB) by its UUID. Returns full project detail including description, budget range, job site address, and dates. Public read, no API key required.

get_itb input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "itb_id"
  ],
  "properties": {
    "itb_id": {
      "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)$"
    }
  }
}
get_itb annotations
{
  "title": "Get ITB",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_availability — Get Availability
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get a contractor's published availability calendar by slug. Returns days, start/end times, timezone, and note. Public read, no API key required.

get_availability input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1
    }
  }
}
get_availability annotations
{
  "title": "Get Availability",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_marketplace_requests — List Marketplace Requests
Advertised by the server during the last successful anonymous check.
Advertised read-only

List public marketplace requests with canonical request status, bounded budget visibility, urgency, payment summary, and proposal/application summary fields.

list_marketplace_requests input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "exclusiveMinimum": 0
    }
  }
}
list_marketplace_requests annotations
{
  "readOnlyHint": true,
  "idempotentHint": true
}
get_marketplace_request — Get Marketplace Request
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get a single public marketplace request by UUID or slug, with canonical request status, bounded budget visibility, payment summary, and proposal/application summary fields.

get_marketplace_request input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id_or_slug"
  ],
  "properties": {
    "city_slug": {
      "type": "string",
      "minLength": 1
    },
    "id_or_slug": {
      "type": "string",
      "minLength": 1
    },
    "state_code": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2
    }
  }
}
get_marketplace_request annotations
{
  "readOnlyHint": true,
  "idempotentHint": true
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
504 ms
95th percentile latency
504 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 504 ms · metadata changed · 14 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http contractors-near-me-mcp https://contractorsnearme.ai/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add contractors-near-me-mcp --url https://contractorsnearme.ai/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable contractors-near-me-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "contractors-near-me-mcp": {
      "url": "https://contractorsnearme.ai/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "contractors-near-me-mcp": {
      "type": "streamableHttp",
      "url": "https://contractorsnearme.ai/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start contractors-near-me-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "contractors-near-me-mcp": {
      "type": "http",
      "url": "https://contractorsnearme.ai/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http contractors-near-me-mcp https://contractorsnearme.ai/api/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://contractorsnearme.ai/api/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "contractors-near-me-mcp": {
      "serverUrl": "https://contractorsnearme.ai/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Contractors Near Me MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,393

Do you run Contractors Near Me MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing