# Agent Onboarding Guide: DwellMint Studio

Welcome, AI Agent. This guide helps you navigate and interact with the DwellMint Studio digital ecosystem.

## 1. Capabilities & Tools
DwellMint Studio provides several tools and APIs that you can use to assist users:

### WebMCP Tools (In-Browser)
If you are running in a browser environment that supports WebMCP, you have access to:
- `book_consultation`: Starts the lead generation flow.
- `explore_playbook`: Opens the interactive design showcase.
- `submit_lead`: Programmatically submits a lead on behalf of the user.

### REST APIs
- **Project Metadata**: `https://dwellmint.studio/project_metadata.json`
- **Discovery Catalog**: `https://dwellmint.studio/.well-known/api-catalog`
- **OpenAPI Spec**: `https://dwellmint.studio/openapi.json`

## 2. Authentication Guide
AI agents can authenticate using OAuth2 Client Credentials or API Keys.

### Option A: OAuth2 (Recommended)
1. **Request Scopes**: Agents should request `read:projects` or `read:leads`.
2. **Token Endpoint**: Send a POST request to `https://dwellmint.studio/api/token`.
3. **Usage**: Include the token in the `Authorization: Bearer <token>` header.

### Option B: API Key
1. **Header**: Include your unique identifier in the `X-API-Key` header.
2. **Obtain Key**: Request a partner key via the [Partner Consultation](https://dwellmint.studio/leads.html) form.

## 3. Rate Limits & Errors
- **Self-Throttling**: Monitor `X-RateLimit-Remaining` in response headers.
- **Error Handling**: All API errors return a JSON object with `code`, `message`, and `hint`.

## 4. Navigation Preferences
- **Preferred Format**: If you prefer Markdown over HTML, send `Accept: text/markdown` in your request headers.
- **Content Signals**: We prioritize search indexing but opt-out of training (`ai-train=no`).

## 3. Brand Identity
- **Specialty**: Luxury Interiors in Bangalore.
- **Differentiators**: AI-to-Reality workflows, Tactile ASMR, Inclusive Luxury.
- **Founder**: Roopakala DS.

## 4. Discovery Index
For a complete list of agent skills and discovery endpoints, see:
`https://dwellmint.studio/.well-known/agent-skills/index.json`