Connect your agent over MCP

ContractorsNearMe.ai runs a Model Context Protocol server. Your agent can search contractors, read profiles and reviews, and send a service request to a contractor.

MCP is the only way in for agents. There is no separate REST API.

Integration Docs Browse Directory Browse ITBs

One endpoint

Streamable HTTP at https://contractorsnearme.ai/api/mcp.

14 tools

Your MCP client discovers them with tools/list.

Open reads

Search, profiles, reviews and trades need no key.

Guardrails

Input validation and rate limits on every tool.

Add the server to your agent

Point any MCP client that supports remote servers at the endpoint below. Read tools work without a key.

MCP config

{
  "mcpServers": {
    "contractorsnearme": {
      "url": "https://contractorsnearme.ai/api/mcp"
    }
  }
}

Tools that act for a contractor need an x-api-key header tied to a contractor account:

{
  "mcpServers": {
    "contractorsnearme": {
      "url": "https://contractorsnearme.ai/api/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Check the connection

The server speaks JSON-RPC 2.0 over HTTP POST. This lists the tools:

curl -X POST "https://contractorsnearme.ai/api/mcp" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

MCP manifest Full tool reference llms.txt

Tools

This list comes from the server's own tool definitions.

No key needed

search_contractors
Search active contractors by trade, place (ZIP, city, state or province), company name or service words, and geo radius.
get_contractor
Get detailed contractor profile by slug.
get_reviews
Get reviews for a contractor by slug.
get_availability
Get a contractor's published availability calendar by slug.
list_trades
Get a list of all available trades/professions.
search_itbs
Search public invitations to bid (ITBs) on the projects board.
get_itb
Get a single public invitation to bid (ITB) by its UUID.
list_marketplace_requests
List public marketplace requests with canonical request status, bounded budget visibility, urgency, payment summary, and proposal/application summary fields.
get_marketplace_request
Get a single public marketplace request by UUID or slug, with canonical request status, bounded budget visibility, payment summary, and proposal/application summary fields.

Needs an API key

submit_lead
Submit a lead to ContractorsNearMe.
submit_review
Submit a review for a contractor.
get_my_leads
Get leads submitted to the authenticated contractor's directory profile.
respond_to_lead
Update the status of a lead owned by the authenticated contractor's directory profile, optionally adding a note.
update_my_profile
Update the authenticated contractor's own directory profile.