---
name: milk-market
description: Browse and buy local food, and manage a producer stall, on Milk Market (a permissionless Bitcoin-native Nostr marketplace) via its Model Context Protocol (MCP) server.
homepage: https://milk.market
mcp_endpoint: https://milk.market/api/mcp
auth: Bearer API key (prefix "sk_") with scopes read, read_write, full_access
version: 2.1.0
---

# Milk Market Skill

Milk Market is a permissionless marketplace for local food and decentralized
food systems, built on Nostr. Use this skill to participate as a buyer or a
seller through the Model Context Protocol (MCP).

## Connect

- Endpoint: `POST https://milk.market/api/mcp`
- Transport: JSON-RPC 2.0 over Streamable HTTP
- Authentication: send `Authorization: Bearer sk_...`
- Scopes:
  - `read`: search and read public data (no key needed for some reads)
  - `read_write`: place and track orders
  - `full_access`: manage your own listings, stall, profile, and wallet

Get an API key from the Milk Market app (Settings → API keys) or via the
onboarding endpoint.

## Common tasks

### Find products
Call `search_products` with optional `keyword`, `category`, `location`,
`minPrice`, `maxPrice`, `currency`, and `limit`. Then `get_product_details`
with a `productId` for the full listing.

### Place an order
Call `create_order` with `productId`, optional `quantity`, `buyerEmail`,
`discountCode`, and `paymentMethod` (`stripe`, `lightning`, `cashu`, or `fiat`).
Track it with `get_order_status` and confirm Lightning payments with
`verify_payment`.

### Sell
Use `set_shop_profile` and `create_product_listing` to open a stall and list
products. Update with `update_product_listing`, remove with `delete_listing`,
and manage discounts with `create_discount_code` / `list_discount_codes`.

### Communicate
Use `send_direct_message` for encrypted (NIP-17) messages to buyers or sellers.

## Universal Commerce Protocol (UCP)

If you prefer plain REST over MCP's JSON-RPC, Milk Market also speaks the
Universal Commerce Protocol (the standard backed by Google and Shopify). It runs
on the same catalog and order pipeline as MCP, so the two never drift.

- Discovery: `GET https://milk.market/.well-known/ucp` advertises a catalog
  capability and a checkout capability, each with a JSON Schema.
- Browse: `GET /api/ucp/catalog/search` (filters + pagination) and
  `GET /api/ucp/catalog/lookup` (single product, live inventory). No key needed.
- Buy: `POST /api/ucp/checkout/sessions` creates a checkout session that places a
  Milk Market order; `GET /api/ucp/checkout/sessions/{id}` tracks its status.
  These require a `read_write` API key (the same `sk_` keys as MCP).
- Schemas: `/api/ucp/schemas/product.json` and
  `/api/ucp/schemas/checkout-session.json`; everything is also in `/openapi.json`.

## Discovery

- `https://milk.market/llms.txt`: site overview for LLMs
- `https://milk.market/.well-known/mcp.json`: MCP discovery document
- `https://milk.market/.well-known/ucp`: Universal Commerce Protocol profile
- `https://milk.market/.well-known/agent-card.json`: Google A2A agent card
- `https://milk.market/openapi.json`: OpenAPI description
- `https://milk.market/agents.txt`: access policy and rate limits

## Etiquette

Respect rate limits (HTTP 429 + `Retry-After`), identify your agent with a
descriptive User-Agent, and never attempt to read end-to-end-encrypted order or
message content you are not a party to.