Developers
Search pros by trade and place. Get hours, phone and booking links. Ask a pro to call back, with a text code.
Public API
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
The same details anyone sees on the listing page. Never owner emails, homeowner leads or private notes.
curl "https://pro.serviceforge.com/v1/pros?trade=plumbing&city=dallas"MCP Server
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
One write tool: a callback request. The person confirms with a text code. Pros do the talking.
Hidden or closed listings never show up. Unclaimed profiles return 404.
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.