HandyPro MCP server for AI agents
Let Claude, ChatGPT or your own agent read HandyPro: 2 typed functions through one MCP server. No HandyPro API key needed.
- Site
- handypro.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just HandyPro
An MCP server for HandyPro alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/handyproEvery site
One MCP server for HandyPro and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
checkServiceAreaChecks whether a ZIP is served by a real local HandyPro franchisee and returns that franchisee's own real hourly rate table (name, phone, address…Arguments
Name Type Required zipcodestringYes Returns
HandyproServiceArea// HandyPro's OWN shapes, not a capability contract. interface HandyproHourlyRate { fromHours: number; toHours: number; pricePerHour: number } interface HandyproServiceArea { covered: boolean; message?: string; // present only when covered is false franchiseeName?: string; phone?: string; city?: string; state?: string; formattedAddress?: string; hourlyRates?: HandyproHourlyRate[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/handypro/checkServiceAreaCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.handypro.checkServiceArea("48334");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.handypro.checkServiceArea("48334"))curl -X POST https://api.bowmark.ai/v1/sites/handypro/checkServiceArea \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"zipcode":"48334"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.handypro.checkServiceArea("48334");searchServiceCategoriesLists HandyPro's real service categories (grab bars, appliance install, TV mounting, painting, drywall, and 100+ more) with real per-ZIP pricing.Arguments
Name Type Required zipcodestringYes querystringNo Returns
HandyproCategorySearchinterface HandyproCategoryPrice { categoryId: string; categoryName: string; parentCategoryName: string; pricingKind: "estimate" | "fixedJob" | "unpriced"; price: number | null; // dollars whatsIncluded: string; } interface HandyproCategorySearch { zipcode: string; covered: boolean; message?: string; // present only when covered is false categories: HandyproCategoryPrice[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/handypro/searchServiceCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.handypro.searchServiceCategories("48334", "grab bar");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.handypro.searchServiceCategories("48334", "grab bar"))curl -X POST https://api.bowmark.ai/v1/sites/handypro/searchServiceCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"zipcode":"48334","query":"grab bar"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.handypro.searchServiceCategories("48334", "grab bar");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/handypro/<function> - OpenAPI
/v1/sites/handypro/openapi.json