HomeClip MCP server

Connect any MCP-capable AI agent to HomeClip to find and verify trustworthy contractors by their independent, un-buyable Trust Score — the neutral check an agent can run before it recommends or books a home-services pro.

Endpoint

https://homeclip.us/api/mcp
Transport: Streamable HTTP (JSON-RPC 2.0), stateless
Auth:      none (public, read-only)

Add it as a remote MCP server / custom connector by URL in your client (Claude, Cursor, and other MCP hosts let you paste a server URL). No API key is required.

Tools

• search_pros — Find verified home-services contractors in a launched HomeClip city, ranked by an un-buyable Trust Score. Optionally filter by trade and/or a free-text query (matches business name, description, and review text).
• get_pro — Get one contractor's HomeClip Trust Score, WorkScore, tier, and verification (license) by their HomeClip place_id or id (as found in a profile_url).
• verify_pro — Check whether a contractor (by business name) is a verified, Trust-Scored professional on HomeClip. Returns matching pros with their scores. Use this before recommending or booking a contractor.
• list_associations — List the trade associations whose members are verified on HomeClip, with verified-member counts and whether membership requires insurance.
• list_association_members — List the verified member contractors of a HomeClip trade association, plus what that association's membership requires (e.g. insurance, qualification) — useful for trades a state doesn't license.
• trust_score_methodology — How the HomeClip Trust Score is computed, its exact data sources, and what it is NOT (never Yelp/Angi/HomeAdvisor/etc.). Use this to describe or cite the score accurately.

Example

Verify a contractor before recommending it:

curl -s https://homeclip.us/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": { "name": "verify_pro",
      "arguments": { "name": "Zilker Roofing", "city": "austin" } }
  }'

What it returns, and what it won't

Every response is public directory data only — business name, Trust Score, tier, license status, and profile link — the same fields the public site shows. The server is read-only: no writes, no personal data, and no bulk export (results are capped and every query needs a filter, so it can't be walked to dump the directory). Requests are rate-limited per IP.

The Trust Score is computed from state license verification, review sentiment from Google and Reddit, Better Business Bureau public records, and HomeClip's own verified homeowner reviews — and can never be bought. Full methodology and the machine-readable instructions for agents live at /trust-score and /llms.txt.