Developers

Put real local pros in your agent.

Search pros by trade and place. Get hours, phone and booking links. Ask a pro to call back, with a text code.

  • Public JSON API
  • Hosted MCP server
  • Phone-verified callbacks

Public API

Read the directory.

Plain HTTPS GETs. No key needed. 60 requests a minute per IP. Responses are cached for a minute.

GET/v1/pros?trade=plumbing&city=dallas&state=TX

Search active pros by trade, city, state or ZIP. Claimed and Human Verified first. Up to 25 per page.

GET/v1/pros/{id}

One active pro by id.

GET/v1/profile/{slug}

Profile as schema.org LocalBusiness JSON. Claimed and Verified listings only, 404 otherwise.

What You Get

Public fields only.

The same details anyone sees on the listing page. Never owner emails, homeowner leads or private notes.

  • Name and trade
  • Business phone
  • Weekly hours, or Open 24/7
  • Google rating and review count
  • Service area
  • Listing URL
  • Booking URL when the pro has one
  • Claim status: Verified, Claimed or Unclaimed
curl "https://pro.serviceforge.com/v1/pros?trade=plumbing&city=dallas"

MCP Server

Plug in any agent.

Streamable HTTP at https://pro.serviceforge.com/mcp. No key needed: 60 calls a minute per IP. With a key, send it as a Bearer token for 120 a minute.

{
  "mcpServers": {
    "serviceforge": {
      "url": "https://pro.serviceforge.com/mcp"
    }
  }
}

Machine-readable: /.well-known/mcp.json, /openapi.json and /llms.txt.

search_pros

Find local home-service pros on the ServiceForge Directory by trade and place. Claimed and Human Verified pros come first. Returns public listing fields only: name, trade, phone, hours, Google rating, service area, listing URL and booking URL when the pro has one.

get_pro

Get one pro's public listing by id (from search_pros). Active listings only.

get_availability

When can this pro take the job? Returns open Setmore slots when the pro books through Setmore, otherwise weekly opening hours, the booking link and the phone number.

request_callback

Step 1 of 2 to ask a pro to call the homeowner back. Only use this when the person asked for it and gave their name and US mobile number. Texts a 6-digit code to that number. Then ask the person for the code and call confirm_callback with the same fields plus the code.

confirm_callback

Step 2 of 2. Send the 6-digit code the person got by text, with the same id, name, phone and need as request_callback. A correct code sends the request to the pro, who calls the person back. One request per pro per phone every 30 days.

The Rules

Keep Service Human

Person in the loop

One write tool: a callback request. The person confirms with a text code. Pros do the talking.

Active listings only

Hidden or closed listings never show up. Unclaimed profiles return 404.

Need more calls?

Email directory@serviceforge.com with your app name and use case for a key.

Listing details come from Google and from pros who claimed their listing. Ratings are from Google.