Find U.S. contractors, plan home projects and send quote requests to escrow-enabled pros
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancels one of the homeowner's quote requests and notifies the contractor. If the contractor already sent a quote that is still open, that quote is declined. Requests whose quote was accepted are jobs and cannot be cancelled here. Confirm with the homeowner first. Calling it again for a cancelled request changes nothing. Requires a linked RateDeed account (scope quotes:write).
Request ID to cancel, e.g. QR-7K2M9QXD4T.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http ratedeed https://www.ratedeed.com/mcp
Cancels one of the homeowner's quote requests and notifies the contractor. If the contractor already sent a quote that is still open, that quote is declined. Requests whose quote was accepted are jobs and cannot be cancelled here. Confirm with the homeowner first. Calling it again for a cancelled request changes nothing. Requires a linked RateDeed account (scope quotes:write).
| Argument | Type | Description |
|---|---|---|
| request_id* | string | Request ID to cancel, e.g. QR-7K2M9QXD4T. |
{
"type": "object",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"pattern": "^[Qq][Rr]-[0-9A-Za-z]{10}$",
"description": "Request ID to cancel, e.g. QR-7K2M9QXD4T."
}
},
"additionalProperties": false
}Get a contractor's RateDeed profile by slug (from search_contractors): services, service area, rating, review summary, license verification, contact details and escrow_enabled. Read-only.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Contractor slug from search results. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 200,
"description": "Contractor slug from search results."
}
},
"additionalProperties": false
}Shows the status of the homeowner's quote requests: pending (waiting for the contractor), quoted (with the quote total, card processing fee, payment schedule and expiry), accepted (with job and escrow status), quote_declined, quote_expired or cancelled. Pass request_id for one request, or omit it to list the most recent ones. Read-only. Requires a linked RateDeed account (scope quotes:read).
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many recent requests to list when request_id is omitted. |
| request_id | string | Request ID from submit_quote_request, e.g. QR-7K2M9QXD4T. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "How many recent requests to list when request_id is omitted."
},
"request_id": {
"type": "string",
"pattern": "^[Qq][Rr]-[0-9A-Za-z]{10}$",
"description": "Request ID from submit_quote_request, e.g. QR-7K2M9QXD4T."
}
},
"additionalProperties": false
}Suggest remodel and repair projects for a space in the home, ranked for the homeowner's goals and budget, with rough US cost tiers and the trades that do the work. For a photo-based plan, the homeowner can use the remodel_ideas_url. Read-only.
| Argument | Type | Description |
|---|---|---|
| goals | array | What the homeowner wants to improve. |
| space* | string | Which part of the home. |
| budget | string | low = under $2.5k, mid = $2.5k-$15k, high = $15k+. |
| condition | string | worn = dated or damaged; fresh = recently updated. |
{
"type": "object",
"required": [
"space"
],
"properties": {
"goals": {
"type": "array",
"items": {
"enum": [
"refresh",
"repair",
"light",
"storage",
"value",
"efficiency",
"outdoor"
],
"type": "string"
},
"description": "What the homeowner wants to improve."
},
"space": {
"enum": [
"kitchen",
"bathroom",
"living_room",
"bedroom",
"dining_room",
"home_office",
"laundry",
"basement",
"attic",
"garage",
"entry",
"exterior",
"backyard",
"under_construction",
"utility"
],
"type": "string",
"description": "Which part of the home."
},
"budget": {
"enum": [
"any",
"low",
"mid",
"high"
],
"type": "string",
"default": "any",
"description": "low = under $2.5k, mid = $2.5k-$15k, high = $15k+."
},
"condition": {
"enum": [
"worn",
"fresh",
"unknown"
],
"type": "string",
"default": "unknown",
"description": "worn = dated or damaged; fresh = recently updated."
}
},
"additionalProperties": false
}Find contractors near a US ZIP code for a job described in plain English (e.g. "water stain on my ceiling", "replace old carpet with hardwood"). Returns ranked local pros with ratings, distance, license verification and escrow_enabled (whether RateDeed can send them a quote request). Read-only.
| Argument | Type | Description |
|---|---|---|
| zip* | string | 5-digit US ZIP code of the property. |
| limit | integer | |
| trade | string | Optional: restrict to one trade if already known. |
| request* | string | What the homeowner needs done, in their own words. |
{
"type": "object",
"required": [
"request",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}$",
"description": "5-digit US ZIP code of the property."
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1
},
"trade": {
"enum": [
"Plumbers",
"Electricians",
"HVAC",
"Roofers",
"Painters",
"Landscapers",
"Cleaners",
"Handymen",
"Carpenters",
"General Contractors",
"Concrete",
"Flooring",
"Masons",
"Drywall",
"Insulation",
"Framing"
],
"type": "string",
"description": "Optional: restrict to one trade if already known."
},
"request": {
"type": "string",
"maxLength": 300,
"description": "What the homeowner needs done, in their own words."
}
},
"additionalProperties": false
}Read-only. With contractor_slug, checks whether that pro can receive a quote request; otherwise picks up to 3 escrow-enabled pros near the ZIP for the job. Returns each pro with a prefilled RateDeed link for homeowners without a linked account. With a linked account, send the request directly with submit_quote_request. Nothing is sent or charged by this tool.
| Argument | Type | Description |
|---|---|---|
| zip* | string | 5-digit US ZIP code of the property. |
| trade | string | Trade for the job, if known. |
| project_title* | string | Short title, e.g. "Replace leaking kitchen faucet". |
| contractor_slug | string | Optional: a specific contractor from search_contractors. |
| project_description* | string | Details the contractor needs: what, where, size, timing. |
{
"type": "object",
"required": [
"zip",
"project_title",
"project_description"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}$",
"description": "5-digit US ZIP code of the property."
},
"trade": {
"enum": [
"Plumbers",
"Electricians",
"HVAC",
"Roofers",
"Painters",
"Landscapers",
"Cleaners",
"Handymen",
"Carpenters",
"General Contractors",
"Concrete",
"Flooring",
"Masons",
"Drywall",
"Insulation",
"Framing"
],
"type": "string",
"description": "Trade for the job, if known."
},
"project_title": {
"type": "string",
"maxLength": 100,
"description": "Short title, e.g. \"Replace leaking kitchen faucet\"."
},
"contractor_slug": {
"type": "string",
"maxLength": 200,
"description": "Optional: a specific contractor from search_contractors."
},
"project_description": {
"type": "string",
"maxLength": 1000,
"description": "Details the contractor needs: what, where, size, timing."
}
},
"additionalProperties": false
}Sends a quote request from the signed-in homeowner to one escrow-enabled contractor and returns a request_id. This shares the homeowner's name and the project details (title, description, ZIP, timeline, budget) with that contractor and starts a RateDeed conversation with them. It does not charge anything or commit the homeowner to hire. Before calling, show the homeowner the contractor and every field that will be sent, and get their approval; ask again if any detail changes. Only contractors with escrow_enabled=true can receive requests. Use a new idempotency_key for each new request and reuse it when retrying the same one; after a timeout or error, call get_request_status without request_id to check whether it was sent before retrying. Requires a linked RateDeed account (scope quotes:write).
| Argument | Type | Description |
|---|---|---|
| zip* | string | 5-digit US ZIP code of the property. |
| budget | string | The homeowner's target budget range, if they gave one. |
| category | string | Project category, if known. |
| timeline | string | When the homeowner wants it done: asap (24-48 hours), 1-2-weeks, 1-month, flexible. |
| project_title* | string | Short title, e.g. "Replace leaking kitchen faucet". |
| contractor_slug* | string | Slug of an escrow_enabled contractor from search_contractors. |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 6, 2026.
| idempotency_key | string | Unique per request (e.g. a UUID). Retrying with the same key never sends a second request. |
| project_description* | string | What needs doing: the problem, rooms or areas, sizes, materials. Do not include phone numbers, emails or payment details. |
{
"type": "object",
"required": [
"contractor_slug",
"project_title",
"project_description",
"zip"
],
"properties": {
"zip": {
"type": "string",
"pattern": "^\\d{5}$",
"description": "5-digit US ZIP code of the property."
},
"budget": {
"enum": [
"under-1k",
"1k-3k",
"3k-5k",
"5k-10k",
"10k-25k",
"25k-plus",
"not-sure"
],
"type": "string",
"description": "The homeowner's target budget range, if they gave one."
},
"category": {
"enum": [
"Plumbing",
"Electrical",
"HVAC & Heating",
"Roofing",
"Painting",
"Remodeling",
"Flooring",
"Landscaping",
"Carpentry",
"Handyman",
"Masonry",
"General Contracting"
],
"type": "string",
"description": "Project category, if known."
},
"timeline": {
"enum": [
"asap",
"1-2-weeks",
"1-month",
"flexible"
],
"type": "string",
"description": "When the homeowner wants it done: asap (24-48 hours), 1-2-weeks, 1-month, flexible."
},
"project_title": {
"type": "string",
"maxLength": 100,
"minLength": 3,
"description": "Short title, e.g. \"Replace leaking kitchen faucet\"."
},
"contractor_slug": {
"type": "string",
"maxLength": 200,
"description": "Slug of an escrow_enabled contractor from search_contractors."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+$",
"maxLength": 200,
"minLength": 8,
"description": "Unique per request (e.g. a UUID). Retrying with the same key never sends a second request."
},
"project_description": {
"type": "string",
"maxLength": 1000,
"minLength": 15,
"description": "What needs doing: the problem, rooms or areas, sizes, materials. Do not include phone numbers, emails or payment details."
}
},
"additionalProperties": false
}