Servidor MCP

Contractors Near Me

ai.contractorsnearme/contractors-near-me

Qué hace este MCP

Searches contractor directories and project bids, retrieves profiles and reviews, and supports lead submission and management.

get_availability
Get Availability
Get a contractor's published availability calendar by slug. Returns days, start/end times, timezone, and note. Public read, no API key required.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1}}}
get_contractor
Get Contractor Profile
Get detailed contractor profile by slug. Returns full profile including about text, contact info, and trade details.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1}}}
get_itb
Get ITB
Get a single public invitation to bid (ITB) by its UUID. Returns full project detail including description, budget range, job site address, and dates. Public read, no API key required.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['itb_id'], 'properties': {'itb_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$'}}}
get_marketplace_request
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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id_or_slug'], 'properties': {'city_slug': {'type': 'string', 'minLength': 1}, 'id_or_slug': {'type': 'string', 'minLength': 1}, 'state_code': {'type': 'string', 'maxLength': 2, 'minLength': 2}}}
get_my_leads
Get My Leads
Get leads submitted to the authenticated contractor's directory profile. Requires API key authentication. Returns lead name, email, phone, message, status, source, and created date.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'status': {'type': 'string'}}}
get_reviews
Get Contractor Reviews
Get reviews for a contractor by slug. Returns review text, rating, reviewer name, and dates. Limited to 50 per request.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contractor_slug'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'contractor_slug': {'type': 'string', 'minLength': 1}}}
list_marketplace_requests
List Marketplace Requests
List public marketplace requests with canonical request status, bounded budget visibility, urgency, payment summary, and proposal/application summary fields.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'minLength': 1}, 'limit': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}}
list_trades
List Trades
Get a list of all available trades/professions. Returns filtered list of contractor trades from the directory.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
respond_to_lead
Respond to Lead
Update the status of a lead owned by the authenticated contractor's directory profile, optionally adding a note. Requires API key authentication. Allowed statuses: new, contacted, qualified, converted, lost.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['lead_id'], 'properties': {'note': {'type': 'string', 'maxLength': 2000}, 'status': {'enum': ['new', 'contacted', 'qualified', 'converted', 'lost'], 'type': 'string'}, 'lead_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$'}}}
search_contractors
Search Contractors
Search active contractors by trade, location, company name, and geo radius.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'minLength': 1}, 'lat': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'lng': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'city': {'type': 'string', 'minLength': 1}, 'limit': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'trade': {'type': 'string', 'minLength': 1}, 'accountType': {'enum': ['gc', 'supplier', 'subcontractor', 'customer'], 'type': 'string'}, 'customerOnly': {'type': 'boolean'}, 'radius_miles': {'type': 'number', 'exclusiveMinimum': 0}, 'contractorCategory': {'enum': ['gc', 'supplier', 'subcontractor'], 'type': 'string'}}}
search_itbs
Search ITBs
Search public invitations to bid (ITBs) on the projects board. Returns open project title, description, budget range, location, and created date. Public read, no API key required.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'city': {'type': 'string', 'maxLength': 100}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'state_code': {'type': 'string', 'maxLength': 2, 'minLength': 2}}}
submit_lead
Submit Lead
Submit a lead to ContractorsNearMe. Requires API key authentication.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'email', 'message'], 'properties': {'name': {'type': 'string', 'minLength': 2}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'phone': {'type': 'string'}, 'message': {'type': 'string', 'minLength': 10}, 'trade_slug': {'type': 'string'}, 'contractor_slug': {'type': 'string'}}}
submit_review
Submit Review
Submit a review for a contractor. Requires API key authentication. Reviews are held for moderation before publishing.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['contractor_slug', 'rating', 'description', 'reviewer_name'], 'properties': {'title': {'type': 'string'}, 'rating': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'description': {'type': 'string', 'minLength': 20}, 'rating_value': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'reviewer_name': {'type': 'string', 'minLength': 2}, 'rating_quality': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'contractor_slug': {'type': 'string', 'minLength': 1}, 'rating_timeliness': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'rating_cleanliness': {'type': 'integer', 'maximum': 5, 'minimum': 1}, 'rating_communication': {'type': 'integer', 'maximum': 5, 'minimum': 1}}}
update_my_profile
Update My Profile
Update the authenticated contractor's own directory profile. Requires API key authentication. Only the profile owned by the key's contractor can be updated.
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'dba': {'type': 'string', 'maxLength': 200}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}, 'phone': {'type': 'string', 'maxLength': 40}, 'quote': {'type': 'string', 'maxLength': 300}, 'website': {'type': 'string', 'maxLength': 500}, 'about_text': {'type': 'string', 'maxLength': 5000}, 'company_name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'company_size': {'type': 'string', 'maxLength': 100}, 'license_number': {'type': 'string', 'maxLength': 100}, 'year_established': {'type': 'integer', 'maximum': 2100, 'minimum': 1800}}}
Añadido
get_marketplace_request
11 de September de 2026 a las 15:33
Añadido
list_marketplace_requests
11 de September de 2026 a las 15:33
Añadido
get_availability
11 de September de 2026 a las 15:33
Añadido
get_itb
11 de September de 2026 a las 15:33
Añadido
search_itbs
11 de September de 2026 a las 15:33
Añadido
update_my_profile
11 de September de 2026 a las 15:33
Añadido
respond_to_lead
11 de September de 2026 a las 15:33
Añadido
get_my_leads
11 de September de 2026 a las 15:33
Añadido
submit_review
11 de September de 2026 a las 15:33
Añadido
submit_lead
11 de September de 2026 a las 15:33
Añadido
list_trades
11 de September de 2026 a las 15:33
Añadido
get_reviews
11 de September de 2026 a las 15:33
Añadido
get_contractor
11 de September de 2026 a las 15:33
Añadido
search_contractors
11 de September de 2026 a las 15:33