# Bucky — Agent Entrypoint

> The collaboration platform powering pre-development for residential construction in Canada.

This file is the conventional entry point for coding agents and AI assistants discovering Bucky on the public web.

## What Bucky Is

Bucky structures residential pre-development: zoning feasibility, design intent, scoped proposals, and vetted professional matching — before construction starts. Audiences: homeowners, architects, builders, designers, municipalities.

**Not:** licensed A/E/legal advice, a builder, or a lender. Residential only. Active in Canada (especially BC).

## Discovery

| Resource             | URL                                                                        |
| -------------------- | -------------------------------------------------------------------------- |
| Index                | [/llms.txt](https://buckybuild.com/llms.txt)                               |
| Deep brief           | [/llms.md](https://buckybuild.com/llms.md)                                 |
| Full curated mirrors | [/llms-full.txt](https://buckybuild.com/llms-full.txt)                     |
| Markdown sitemap     | [/sitemap.md](https://buckybuild.com/sitemap.md)                           |
| API catalog          | [/.well-known/api-catalog](https://buckybuild.com/.well-known/api-catalog) |
| OpenAPI (public)     | [/api/openapi](https://buckybuild.com/api/openapi)                         |
| Documentation        | [docs.buckybuild.com](https://docs.buckybuild.com/docs)                    |
| Glossary             | [/en/glossary](https://buckybuild.com/en/glossary)                         |

Prefer `.md` URLs from [/sitemap.md](https://buckybuild.com/sitemap.md) for page-level content.

## Configuration

Bucky integrations use environment variables — never hardcode secrets.

```bash
# Supabase (auth + data)
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

# Optional: server-side API access
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
```

See [docs quickstart](https://docs.buckybuild.com/docs/getting-started/quickstart) for full setup.

## Usage

### HTTP API

Fetch the public OpenAPI spec, then call endpoints with a valid Supabase session or service token:

```bash
curl -s https://buckybuild.com/api/openapi | head
```

### MCP

Bucky exposes MCP tools for agents. See [MCP docs](https://docs.buckybuild.com/docs/mcp).

### Product UI

- Home: https://buckybuild.com/en
- Marketplace: https://buckybuild.com/en/market
- How it works: https://buckybuild.com/en/how-it-works.md

## Contact

- hello@buckybuild.com
- support@buckybuild.com

Last updated: 2026-07-22