My Painting Club — Painting Lessons

What My Painting Club — Painting Lessons does

My Painting Club — Painting Lessons MCP server provides search access to transcribed painting lessons from mypaintingclub.com. An AI agent can submit a natural-language question about a painting technique and receive matching lesson content rather than relying only on general model knowledge.

Each result can include the relevant answer passage, the lesson title, a sales-page URL, and a Vimeo deep link that opens the video at the corresponding point. This makes the service useful for finding both written guidance and the source lesson segment behind that guidance.

The indexed subjects include colour mixing, edges, composition, value, brushwork, oil painting, and acrylic painting. Questions can be specific, such as asking how to create soft edges in oils.

How it works

The service is hosted remotely at https://mypaintingclub.com/kb/mcp and uses Streamable HTTP with MCP 2025-03-26. No authentication is required according to the provided connection details.

The search_painting_lessons tool requires a question string. An optional top_k integer controls the maximum number of returned results; it defaults to 5 and accepts values from 1 through 20. For example, an agent could ask about soft edges in oil painting and request three results.

The service also publishes MCP auto-discovery at /.well-known/mcp.json, an OpenAI plugin manifest at /.well-known/ai-plugin.json, an OpenAPI description at /kb/openapi.json, API documentation at /kb/docs, and a health endpoint at /kb/health.

Setup and configuration

Add the remote endpoint as a Streamable HTTP MCP server in a compatible client. Claude Desktop can use the following configuration:

{
  "mcpServers": {
    "mpc-painting-lessons": {
      "type": "streamable-http",
      "url": "https://mypaintingclub.com/kb/mcp"
    }
  }
}

Cursor and other MCP clients can be configured with the same URL as a Streamable HTTP server. No environment variables, local package installation, or credentials are specified for this remote service.

Tools and capabilities

My Painting Club — Painting Lessons exposes one MCP tool:

• search_painting_lessons: Searches transcribed lesson content using a required natural-language question and an optional top_k result limit.

Returned information is designed to preserve source context. Results may identify the lesson, link to its sales page on mypaintingclub.com, and provide a Vimeo URL that starts at the relevant timestamp.

Limitations and notes

The service allows 30 requests per minute per IP address and 500 queries per day globally. The daily quota resets at midnight UTC. These limits matter for agents that perform repeated searches or process many questions in a batch.

Search coverage is limited to the transcribed painting lessons available through the knowledge base. The documented subject areas include colour mixing, edges, composition, value, brushwork, oils, and acrylics; the material does not specify broader coverage or guarantees about every query.