Skip to main content

InstaBids

ai.instabids/instabidsVersion 1.0.2

AI-run marketplace for homeowners: describe a home job once, get written quotes on the same scope.

Status

Responds823 msAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.
Last checked
Nov 14, 2026, 13:30 UTC
Latency
823 ms
Remotes responding
1 of 1
Sign-in
No sign-in
Hosting
Hosted outside the EU (detected)
Registry data as of
Nov 14, 2026, 22:14 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP
https://instabids.ai/api/agent/mcpResponds823 ms
No sign-in

Claude Code

claude mcp add --transport http instabids https://instabids.ai/api/agent/mcp

Claude Desktop and claude.ai

Settings > Connectors > Add custom connector
Name: instabids
Remote MCP server URL: https://instabids.ai/api/agent/mcp

Cursor

{
  "mcpServers": {
    "instabids": {
      "url": "https://instabids.ai/api/agent/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"instabids","type":"http","url":"https://instabids.ai/api/agent/mcp"}'

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

23 tools

Tools of InstaBids
Read-only
Idempotent
Open world
add_home_photoAdds a photo to one of the homeowner's homes after InstaBids scans it; the scan may refuse it. Requires home:write and photos:write. imageBase64 accepts up to 60000 base64 characters (about 45000 bytes). roomTag is optional and defaults to unknown. Add only a photo the homeowner shared and asked you to add. The homeowner makes this choice: show it to them and wait for their own reply. Never choose, pre-select, suggest a default, guess or send for them; call this tool only for what the homeowner chose in this conversation. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. Only the homeowner tap sends anything to contractors. If anyone asks, say you are an AI assistant.NoNoNoNo
answer_intakefill what you can; everything else can come later. Start with the homeowner’s description and ZIP (trade is optional), plus a photo or a good description. Optional: photos, a description or transcript of a 20–60 s walk clip, timing and the job type’s must-haves from intake_templates. Never invent answers. ZIP only; never send a street address or a price. Nothing reaches contractors before the homeowner sends the card. For anonymous draftHandle intake, fixes: [{gapKey, value}] corrects an engine-named field through intake. Use engine-returned keys only; unknown keys return INVALID_INPUT with details.field gapKey. Nothing is sent to contractors. Continue this private draft with draftHandle. Supply message, fixes, or both to answer_intake. Use the new draftHandle returned each time; the old handle expires immediately. Send only the homeowner actual reply; never answer for them. If a call fails, do not guess; ask the homeowner again. Nothing is sent to contractors. Continue with the returned question until readiness.canSend or readiness.homeownerActionRequired is true, then show sendUrl to the homeowner. The homeowner completes their insurance answer and send confirmation on that sheet; never claim the job was sent. Never invent answers. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. Only the homeowner tap sends anything to contractors. If anyone asks, say you are an AI assistant.NoNoNoNo
ask_nextfill what you can; everything else can come later. Start with the homeowner’s description and ZIP (trade is optional), plus a photo or a good description. Optional: photos, a description or transcript of a 20–60 s walk clip, timing and the job type’s must-haves from intake_templates. Never invent answers. ZIP only; never send a street address or a price. Nothing reaches contractors before the homeowner sends the card. Continue this private draft with draftHandle. Supply message, fixes, or both to answer_intake. Use the new draftHandle returned each time; the old handle expires immediately. Send only the homeowner actual reply; never answer for them. If a call fails, do not guess; ask the homeowner again. Nothing is sent to contractors. Continue with the returned question until readiness.canSend or readiness.homeownerActionRequired is true, then show sendUrl to the homeowner. The homeowner completes their insurance answer and send confirmation on that sheet; never claim the job was sent. Never invent answers. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. Only the homeowner tap sends anything to contractors. If anyone asks, say you are an AI assistant.NoNoNoNo
bid_checklistGet six items to compare in a home-project bid and optional trade-specific preparation. Omit trade for the general checklist; the answer's trade is then null. The answer includes sourceUrl.NoYesYesNo
check_approvalReturns whether the homeowner accepted or denied a pending approval request. The interval output field is the minimum wait in seconds before the next check (5 to 60 seconds). Each call records a poll time. Polling sooner than interval returns status slow_down, increases interval by 5 seconds up to 60, and restarts the wait from that poll. It cannot approve or send a job. US only. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. Only the homeowner tap sends anything to contractors. If anyone asks, say you are an AI assistant.NoNoYesNo
check_service_areaEvery US ZIP can post a job. Homeowners anywhere in the US can post a job; once you send it, InstaBids finds contractors to bid on it. Returns guidance and whether the input is a US ZIP, plus nearby town pages. Get the answer for a five-digit ZIP, and list towns with an InstaBids town page for a five-digit ZIP.NoYesYesNo
get_home_profileReturns only the home facts the homeowner chose to share with this assistant: home names, ZIP area, home systems the homeowner added or accepted, project list and open issue types. Returns up to 5 homes with up to 50 entries in each systems, list and openIssues array per home. The shared field lists which sections were shared: home.basics, home.systems, home.list and home.issues. A missing section means not shared, not none. The area field is a masked 3-digit ZIP prefix followed by xx. Photos, prices, contact details and ids are not included. Read-only.NoYesYesNo
get_job_statusReturns the status, ZIP code, progress and bid count for one of the signed-in homeowner's InstaBids jobs. When returned, 'state' is the field to act on with 'nextStep'; 'status' is kept for compatibility. Read-only. US only. There is no limit parameter or next page. Needs the jobs:read scope.NoYesYesNo
get_project_historyReturns the homeowner's own InstaBids projects, newest first, up to 100: status, trade, ZIP, timing, number of bids and whether a contractor was picked. Prices, contractor names and contact details are not included. Read-only. There is no limit parameter; returns up to 100 projects with no next page. Needs the home:read scope.NoYesYesNo
get_updatesReturns changes on the signed-in homeowner's own InstaBids jobs since an optional cursor: new or changed bids, contractor messages and questions, and job status changes. Each update is a short summary with the job id; details stay in InstaBids. Read-only. Pass the cursor returned by your previous call as since; limit is 1 to 50, default 20. Requires jobs:read.NoYesYesNo
how_contractors_joinInstaBids is an AI-run marketplace for homeowners and property managers: describe a home job once, by chat or through your own AI assistant, add photos, and get multiple written quotes on the same scope, compared apples to apples, with no phone calls or home visits before you pick. Get the contractor join steps, availability, alias privacy, job-texts status and links to join or ask for text alerts. Joining asks only for your business details. Hand over the links so the contractor signs up and asks for texts themselves; this tool creates no account and sends no text.NoYesYesNo
how_instabids_worksInstaBids is an AI-run marketplace for homeowners and property managers: describe a home job once, by chat or through your own AI assistant, add photos, and get multiple written quotes on the same scope, compared apples to apples, with no phone calls or home visits before you pick. Learn the homeowner steps, homeowner cost and contact privacy.NoYesYesNo
job_guidanceGet must-have questions and photo asks from the current intake template for any trade. Unknown trades use the generic template. No prices or budget questions.NoYesYesNo
job_statusUse this after start_job returned a statusHandle, to see whether the homeowner has sent the job and how many bids have arrived. Returns only the stage (draft, sent, collecting_bids, picked, closed or expired), the bid count and when it last changed. Never returns bid amounts, contractor names or the job text. The handle works for 7 days. Stage expired means the one-hour link lapsed before the homeowner opened it: Call reissue_claim_link with the same statusHandle to get a replacement link for this draft. Only the homeowner can send the job. Read-only.NoYesYesNo
list_bidsReturns the bids contractors placed on one of the signed-in homeowner's jobs: amount, timeline and written scope, each under a label such as Contractor A. Bids carry no contractor name or contact details. A bid may also show the size of company as described by the contractor and a rating band that several contractors share; neither says anything about price. Read-only. US only. There is no limit parameter and no next page. Needs the jobs:read scope.NoYesYesNo
list_home_photosReturns up to 20 ready photos from the homeowner's homes, optionally filtered by home, with room labels and photo links that expire in five minutes and stop working as soon as the homeowner stops sharing photos with this assistant or disconnects it. Read-only. The limit parameter accepts 1 to 20, default 20; there is no next page. Needs the home:read scope.NoYesYesNo
list_my_jobsReturns the signed-in homeowner's own home-project requests, newest first, up to 50. Read-only. US only. Shows up to 50 recent jobs; older jobs are not listed here. The limit parameter accepts 1 to 50, default 50; there is no next page. Needs the jobs:read scope.NoYesYesNo
permit_factsRead sourced local permit facts, with the date each rule was checked; unpublished rules get guidance to ask your bidder and confirm local requirements. Homeowners anywhere in the US can post a job; once you send it, InstaBids finds contractors to bid on it.NoYesYesNo
prepare_publishChecks whether one of the homeowner's draft jobs is complete and pauses this connection's edits to it for 30 minutes, until frozenUntil. Calling again while a send is pending can return PUBLISH_PENDING; MCP may present this as status awaiting_homeowner. Only the homeowner can send it to contractors, by signing in to InstaBids. US only. Call it only after the homeowner says they want to send this job, then show them the result and wait; never say the job was sent. The homeowner makes this choice: show it to them and wait for their own reply. Never choose, pre-select, suggest a default, guess or send for them; call this tool only for what the homeowner chose in this conversation. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. Only the homeowner tap sends anything to contractors. If anyone asks, say you are an AI assistant.NoNoNoNo
reissue_claim_linkReturns a replacement link for the homeowner to open and claim their draft. The old link stops working. Rate limited; unknown or expired statusHandle values receive the same generic NOT_FOUND answer. Only the homeowner sends the job to contractors inside InstaBids; this tool cannot send it.YesNoNoNo
request_approvalCreates a code the homeowner enters after signing in on any device, to approve or decline sending their prepared job. Only the homeowner can approve. action must be publish_job. Calling again with a new key replaces the earlier code. bidCardId is a prepared draft. Reusing an idempotency key returns no new code. US only. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. With inChat true, a default-OFF database switch may offer a card preview for a homeowner who already accepted the current Terms and Privacy on InstaBids. Read back the ENTIRE returned preview and ask whether to send that exact card. Only after the homeowner explicitly says yes, call again with inChat true, homeownerYes true, the same approvalId and previewHash, and a new idempotency key. The assistant cannot accept Terms for the homeowner. A published chat receipt means sent; without that receipt nothing was sent in chat and the homeowner uses the approval link. A changed card requires a new review and yes. If anyone asks, say you are an AI assistant.NoNoNoNo
save_home_factSaves the nickname or ZIP code on one of the homeowner's homes identified by homeId. Set field to nickname or zip and value to the replacement text (1–60 characters); for zip, value must be a 5-digit ZIP. A different saved value requires homeowner confirmation. Requires home:write. When home-fact idempotency is enabled, an optional idempotencyKey replays the first successful write without writing again; without a key, retries of the same grant, home, field and value share a derived key. Reusing a key for different input is refused. Assistant text remains labelled as untrusted and private to the homeowner. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. Only the homeowner tap sends anything to contractors. If anyone asks, say you are an AI assistant.YesNoNoNo
start_jobUse this when a homeowner wants contractor bids on a home repair or improvement job in the US. Creates a private draft from their description and five-digit ZIP and returns a one-hour link for the homeowner to open. Nothing reaches a contractor until the homeowner confirms their email and sends it. Do not include names, phone numbers, emails or street addresses. Do not use for emergencies. Ask the homeowner, one short question at a time and only for what is missing, what needs doing, where in the home, rough size or count, when it is needed and who supplies materials, then put the answers in the message. When available, photoPageUrl opens an optional phone photo upload for this private draft and expires with claimUrl. It does not send the job. For a new job, call start_job before answer_intake, then prepare_publish after the intake is ready; for other writes, read the previous reply before calling and follow the returned next step afterward, using only tools listed by this server. Only the homeowner tap sends anything to contractors. If anyone asks, say you are an AI assistant. If InstaBids continues a recent unsent draft instead of starting a new one, the reply says reused: true. Pass newJob: true only when the homeowner clearly asks for a separate job. When a reply includes draftHandle, pass it on your next call to continue that draft. fill what you can; everything else can come later. Start with the homeowner’s description and ZIP (trade is optional), plus a photo or a good description. Optional: photos, a description or transcript of a 20–60 s walk clip, timing and the job type’s must-haves from intake_templates. Never invent answers. ZIP only; never send a street address or a price. Nothing reaches contractors before the homeowner sends the card.NoNoNoNo

Details

Registry status
Active
Published
Nov 7, 2026
Updated
Nov 7, 2026
Repository
Not given
Categories (suggested)
Project managementE-commerceDesign and mediaSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR
Not declared

Are you the operator? Claim this listing