Model Context Protocol Integration

Connect AI Shopping Agents

Paintacles supports the Model Context Protocol (MCP). Your AI assistant can browse our original seasonal designs, recommend keepsakes matching a loved one’s story, calculate checkout quotes, and prepare holiday gifts directly within your favourite agent environment.

Generate Agent Token Read the Christmas Shopping Guide Protocol Spec

Endpoint URL https://paintacles.com/api/v1/mcp Stateless JSON-RPC 2.0 over HTTP POST

Public Access No token required Search catalog, product details, reviews

Customer Scopes Scoped Bearer Tokens Cart, quotes, gift packaging, orders

Select your environment

Choose your agent runtime to view configuration file locations and ready-to-paste snippets.

Anthropic (Claude)

Connect Claude Desktop or Claude Code to browse products, run the gift concierge prompt, and assemble shopping carts.

Desktop & CLI

Configuration file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

json snippet

{
  "mcpServers": {
    "paintacles": {
      "url": "https://paintacles.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer pnt_agent_YOUR_SECRET"
      }
    }
  }
}

Replace pnt_agent_YOUR_SECRET with your personal token created in Account > Agent tokens.
Restart Claude Desktop after updating the config file.
For Claude Code, you can also run: claude mcp add paintacles https://paintacles.com/api/v1/mcp --header "Authorization: Bearer pnt_agent_YOUR_SECRET"

What your agent can do

Our server registers both autonomous tools and structured prompts designed for Christmas and seasonal gifting.

recommend_gift Prompt

Ask your agent: "Run the recommend_gift prompt for my mom who loves winter coffee mornings, budget $35." The agent asks clarifying questions about memories and returns matching designs.

configure_gift Tool

Enables direct holiday gifting. The agent can configure gift packaging, attach a personalized holiday greeting card note, and set recipient delivery information.

quote_checkout Tool

Provides accurate shipping and tax estimates for any destination before placing orders. Transparent pricing prevents unexpected charges at checkout.

Spend Limits & Price Freezes

When generating your token, set a maximum spend per order and lifetime limit. If an item price changes between cart preview and order placement, the transaction automatically stops for your safety.

Ready to explore seasonal designs?

Whether you browse through an AI agent or on the site, our designs celebrate moments with loved ones.

Curated occasion gift guides Personalized holiday keepsakes Artisan ceramic morning mugs & blankets