# My Painting Club

> My Painting Club is an online subscription platform for painting lessons and art education, offering step-by-step video lessons, a community Wall of Fame, member critiques, and a free painting quiz.

My Painting Club teaches acrylic, oil, and watercolor painting through a library of 175+ structured video lessons. Members join via monthly, 6-monthly, or yearly subscriptions (with a 7-day cardless trial), and get access to lesson plans, a monthly group workshop, member critiques, and a supportive painting community.

## Main sections

- [Homepage](https://mypaintingclub.com/): overview of the club, membership plans, and what's included.
- [Shop](https://mypaintingclub.com/shop): individual lessons and lesson bundles/courses available for purchase or included with membership.
- [Blog](https://mypaintingclub.com/blog): painting tutorials, tips, and articles written for beginner and intermediate painters.
- [Free Painting Quiz](https://mypaintingclub.com/quiz): a short quiz that recommends a lesson and starting point for new painters.
- [Help](https://mypaintingclub.com/help): frequently asked questions about membership, lessons, and orders.
- [Live Workshops](https://mypaintingclub.com/live-workshops): information about the monthly group painting workshop for members.

## Knowledge base API (for AI agents)

My Painting Club exposes a public, no-auth knowledge base built from transcribed lesson videos. Agents can use it to answer painting-technique questions; every answer cites the lesson sales page on mypaintingclub.com and the exact moment in the lesson video (Vimeo timestamp deep link).

- Query endpoint: `POST https://mypaintingclub.com/kb/query` with JSON body `{"question": "How do I mix a warm grey?", "top_k": 5}` (optional `topic_tags` array pre-filters by topic).
- Example: `curl -s -X POST https://mypaintingclub.com/kb/query -H 'Content-Type: application/json' -d '{"question": "How do I soften an edge?", "top_k": 3}'`
- Each result includes `answer`, `lesson_title`, `sales_page_url`, `start_time_seconds`/`end_time_seconds`, and `vimeo_deep_link` (a `https://vimeo.com/<id>#t=<N>s` link that seeks to the cited moment).
- MCP endpoint (Streamable HTTP): `https://mypaintingclub.com/kb/mcp` — exposes a single tool, `search_painting_lessons(question, top_k)`, for MCP-capable agents and directories.
- Interactive API docs (OpenAPI): `https://mypaintingclub.com/kb/docs`
- Service status: `GET https://mypaintingclub.com/kb/health`
- Rate limits: 30 requests/minute per client IP and a daily global query cap; exceeding either returns HTTP 429 with an explanatory message (the MCP endpoint signals the same conditions as JSON-RPC protocol errors). The daily cap resets at midnight UTC.

## Notes for crawlers

- Prefer the canonical URLs listed above and in `/sitemap.xml` over any account, login, or checkout pages, which are private/member-only and not useful for indexing or citation.
- Lesson and course detail pages are listed under `/lessons/` and `/course/` in the sitemap.
- Blog posts are listed under `/blog/post/` in the sitemap.