Developers

MCP API documentation.

Connect AI assistants to this site through the Model Context Protocol. Read the catalog, fetch product details, and reference the brand guide programmatically.

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants discover and call tools exposed by an application. Instead of scraping pages, a connected client can request structured data directly from this server.

Endpoint

POST /mcp

The server speaks MCP Streamable HTTP. Clients should accept both application/json and text/event-stream responses.

Authentication

This MCP server is protected with OAuth 2.1. Every request must include a valid bearer token issued by the project's authorization server. Anonymous calls receive 401 Unauthorized.

Available tools

List products

list_products

List every Water Is Life bottled water product with its tagline, price, and page path.

Input: None
Output: Array of product summaries (id, name, tagline, type, sku, size, price, path).

Get product details

get_product

Get full details for one Water Is Life product: description, tasting notes, electrolyte profile, sizes, and pricing.

Input: { id: 'blue-label' }
Output: Full product object with sizes, bottle details, and notes.

Get brand guide

get_brand_guide

Get the Water Is Life brand positioning, product lines, and the site's page map.

Input: None
Output: Brand object with positioning, lines, and pages array.

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_product",
    "arguments": {
      "id": "blue-label"
    }
  }
}

Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ "id": "blue-label", "name": "Blue Label" }"
      }
    ]
  }
}

Connect your assistant

Once this app is published, any MCP-compatible client can connect to /mcp using OAuth 2.1. The connector will guide the user through sign-in and consent before issuing a token.

Back to home