# BuildBid Agent Context

> AI-powered construction estimating platform for commercial contractors. Upload blueprints, detect spec conflicts, and generate defensible bids.

BuildBid exposes a rich API surface for AI agents, allowing programmatic creation of estimates, blueprint extraction, 3D model generation, and RFI drafting.

## Platform Architecture

BuildBid runs on Next.js 15 App Router with Supabase Auth, PostgreSQL, Stripe billing, and an asynchronous processing pipeline powered by Node.js. 
The system natively integrates agent loops via the `/api/agent` endpoints, designed around an AI-first workflow for construction estimation.

### Key API Concepts
- **Estimates**: Core domain model. Generated automatically via 3D analysis, blueprint parsing, or voice notes.
- **Agent Chat**: `/api/agent` accepts messages and estimate context, validating credentials before evaluating tools to update estimate state.
- **Vision Extraction**: A comprehensive suite to turn blueprints (`/api/vision/floorplan`), images (`/api/vision/image-to-3d`), and text (`/api/vision/text-to-plan`) into structured data and models.
- **RFI Generation**: Contextual draft creation to resolve missing specifications and architectural discrepancies.

## Connecting to BuildBid

Agents connect to BuildBid using standard `Bearer <token>` authentication headers. We supply an OpenAPI definition at `/api/openapi.json` to allow native agent tool mapping.

For cursor, claude, or local IDEs, BuildBid plans to expose an MCP server endpoint at `/api/mcp` mapping internal procedures to the Model Context Protocol.

### Auth

To authenticate programmatically:
1. Supply `Authorization: Bearer <API_KEY>` 
2. Ensure you track the `connectorTenantId` to properly scope resource access if using Oauth or external connectors.