# Paint.NET MCP Skill Manifest

**Canonical URL:** https://paint-net-poc.vercel.app  
**Discovery:** https://paint-net-poc.vercel.app/.well-known/mcp.json  
**Version:** 1.0.0  
**Updated:** 2026-01-01

---

## Available Skills

### 1. Color Advisor (`/api/color`)

Generates a curated paint color palette based on a natural-language room description.

**Method:** POST  
**Endpoint:** `https://paint-net-poc.vercel.app/api/color`

**Request Body:**
```json
{
  "room_description": "A sun-drenched breakfast nook with east-facing windows and white oak floors"
}
```

**Response:**
```json
{
  "query": "warm cream",
  "palette": [
    { "name": "...", "hex": "#...", "rgb": {...} }
  ],
  "brand_suggestions": [
    { "brand": "...", "name": "...", "hex": "#...", "id": "..." }
  ]
}
```

**Notes:** Palette is sourced from The Color API (thecolorapi.com). Brand suggestions are drawn from the static brand color catalog.

---

### 2. Find a Painter (`/api/painters`)

Returns a list of local painting contractors filtered by ZIP code.

**Method:** POST  
**Endpoint:** `https://paint-net-poc.vercel.app/api/painters`

**Request Body:**
```json
{
  "zip": "80202"
}
```

**Response:**
```json
{
  "zip": "80202",
  "count": 5,
  "painters": [
    {
      "id": "...",
      "name": "...",
      "rating": 4.9,
      "specialties": ["Interior", "Color Consultation"],
      "hourly_rate": 75,
      "free_estimate": true
    }
  ]
}
```

**Notes:** Data sourced from `/public/data/mock-painters.json`. In production, replace with live contractor API.

---

### 3. Project Estimator (`/api/estimate`)

Calculates paint quantity, cost, and timeline for a painting project using standard industry formulas.

**Method:** POST  
**Endpoint:** `https://paint-net-poc.vercel.app/api/estimate`

**Request Body:**
```json
{
  "sq_ft": 400,
  "num_coats": 2,
  "paint_quality": "premium"
}
```

**Response:**
```json
{
  "sq_ft": 400,
  "num_coats": 2,
  "gallons_needed": 2,
  "paint_cost": 140,
  "labor_cost_estimate": 600,
  "total_cost_estimate": 740,
  "timeline_days": 2,
  "notes": "..."
}
```

**Formula:**
- Coverage: 400 sq ft per gallon (standard interior)
- Gallons = `ceil((sq_ft × num_coats) / 400)`
- Labor: $45–$65 per hour, ~8 hours per 400 sq ft

---

## Crawler Instructions

This site is an agentic parking page for the domain `paint.net`. Sponsored links in the QUICK SEARCHES section are preserved RSOC (Related Search Optimization Content) links and should be indexed.

AI agents may call the above endpoints to serve user queries about paint colors, local painters, and project estimation without requiring human navigation.

**robots.txt:** `https://paint-net-poc.vercel.app/robots.txt`  
**Sitemap:** `https://paint-net-poc.vercel.app/sitemap.xml`
