MCP Server

    BidBuild MCP Documentation

    Connect your favorite LLM or MCP client to BidBuild through a single OAuth-secured endpoint. Query jobs, leads, proposals, catalogs, scenes, and more with natural-language commands.

    Server endpoint

    OAuth 2.1
    https://mcp.bidbuild.app/mcp

    Use this URL in any MCP-compatible client. The server authenticates callers through BidBuild OAuth, so every request respects the signed-in user's permissions and data isolation rules.

    How to connect

    Your MCP client registers itself automatically and asks for authorization. You approve once, and the client can act on your behalf until you revoke access.

    Step 01

    Point your client at the server

    Add https://mcp.bidbuild.app/mcp as a remote MCP server in your LLM client, IDE, or automation tool.

    Step 02

    Sign in with BidBuild

    When the client requests access, you’ll be redirected to the BidBuild sign-in screen. Use your existing BidBuild account.

    Step 03

    Approve the OAuth authorization

    Review the client name and scopes, then approve the connection. BidBuild issues a short-lived access token to the client.

    Step 04

    Start calling tools

    The client can now invoke any BidBuild MCP tool your user role allows. Data access follows the same RLS rules as the web app.

    Available tools

    108 BidBuild MCP tools are currently wrapped, grouped by the part of the platform they operate on.

    10 categories

    Jobs / Budget / PO / Bills

    21
    getjobsgetjobslistgetjobboardsgetjobstagesgetjobtypesupdatejobcreatejobmergeproposaltojobgetjobbudgetcreatejobextrabudgetgetpurchaseorderscreatepurchaseorderapprovepurchaseordergetinvoicegetinvoicescreateinvoicereleaseinvoicetoquickbookscreatebillgetjobfinancesgetjobmetricsgettotalsales

    Leads / Proposals

    22
    createleadupdateleadgetleadinfogetleadboardsgetleadboardstagesgetleadsourcesgetleadtagsgetleadtagassociationsgetleadterritoriesgetleadopportunitytypesgetleadactivitysummarycreateleadactivitygetleadlogscreateleadloggetleadproposalsgetleadmetricsgetproposalscreateproposalcreateproposalfromquestionnairegetproposaltemplatesgetquestionnairesgetquestionnairebyid

    Job Logs / To-dos / Time

    14
    getjoblogscreatejobloggettodoscreatetodoupdatetodosettodostatusgettimelogsgettimelogstatisticsgetactivetimelogsloghoursgetjobinspectionsgetjobinspectionstatsgetrfisgetrfistats

    Products / Services / Catalog

    16
    getproductgetproductscreateproductupdateproductgetproducttagsgetservicegetservicescreateserviceupdateservicegetcategoriesgetsubcategoriesgetcostcodesgetmeasurementtypesgetvendorsgetmarkupratesgetjobequipment

    Group Templates

    6
    getgrouptemplatesgetgrouptemplatecreategrouptemplateupdategrouptemplateduplicategrouptemplategetgrouptemplatetags

    Hub / Calendar

    13
    gethubcreatehubsectionupdatehubsectionreorderhubsectionsdeletehubsectioncreatehubblockupdatehubblockreorderhubblocksdeletehubblocksgetteameventscreateteameventupdateteameventdeleteteamevent

    Scenes

    8
    getscenesgetscenecreatesceneupdatescenegetscenewidgetscreatescenewidgetupdatescenewidgetgetscenetags

    Service Tickets

    2
    getjobservicescreateserviceticket

    Users / Clients / Divisions

    4
    getusersgetportalclientsgetclientnotesgetdivisions

    Misc

    2
    uploadfilehealth

    Ready to connect?

    Add the BidBuild MCP server to your client, or explore the platform to see what your teams and customers can do.