NodajiMarket

Search NodajiMarket's curated catalogue of Korean handcrafted goods and artworks by named artists. Artworks marked coa ship with an artist-signed certificate of authenticity. Prices are in USD (integer cents); for Canada, the US, Australia and most of Europe the checkout total is DDP — duties and import taxes included, nothing more to pay on delivery. Returns up to 20 products with price, artist, availability and lead time, plus next_cursor when there are more. Payment is completed by a human in a browser via a Stripe Checkout link (see nodajimarket_create_checkout); no tool here takes payment.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Free-text keywords (Korean or English): material, technique, artist, subject"
    },
    "category": {
      "type": "string",
      "maxLength": 40,
      "description": "Exact category id, e.g. craft, ink_painting, calligraphy"
    },
    "max_price_usd": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Upper bound on item price in US dollars"
    },
    "ship_to": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$",
      "description": "Destination country, ISO 3166-1 alpha-2 (CA, US, JP)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10
    },
    "cursor": {
      "type": "string",
      "maxLength": 400,
      "description": "next_cursor from a previous call"
    }
  },
  "required": [
    "query",
    "ship_to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full detail for one product: description (up to 600 chars), materials, dimensions, weight, images, variants, artist and text rights. Read-only — does not reserve or buy. Use the product id from nodajimarket_search_products.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "product_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Profile of one artist by slug: names (English, Korean, aliases), tagline, story, career (education, exhibitions, awards, designations, collections — all as provided by the artist, not independently verified), portrait, seal image, certificate text, and their works with availability. Read-only.

{
  "type": "object",
  "properties": {
    "artist_slug": {
      "type": "string",
      "minLength": 3,
      "maxLength": 40,
      "pattern": "^[a-z0-9-]+$"
    }
  },
  "required": [
    "artist_slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Delivered (landed) cost for up to 10 products to one destination: items, shipping, duties estimate, tax and the DDP total in USD cents — the same numbers the store's own checkout charges. For Canada the card is charged in CAD at a fixed rate; charged.amountCents shows that. Returns supported:false with a message for destinations we do not ship to (South Korea, sanctioned countries).

{
  "type": "object",
  "properties": {
    "product_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 128
      },
      "minItems": 1,
      "maxItems": 10
    },
    "quantities": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 5
      },
      "description": "Same length as product_ids; default 1 each"
    },
    "ship_to": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$",
      "description": "Destination country, ISO 3166-1 alpha-2 (CA, US, JP)"
    }
  },
  "required": [
    "product_ids",
    "ship_to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Reserve stock for up to 10 products and return a Stripe Checkout link that a human opens in a browser to pay. The link expires in 30 minutes; the reservation is released if it is not paid. Shipping address, name and phone are entered on the Stripe page — do not collect them yourself. For Canada the card is charged in CAD at a fixed rate (returned as charged_amount_cents). This tool does not take payment; only the customer does, on that page. Pass a stable client_request_id so a retry returns the same link instead of reserving stock twice.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5
          }
        },
        "required": [
          "product_id",
          "quantity"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 10
    },
    "ship_to": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Za-z]{2}$",
      "description": "Destination country, ISO 3166-1 alpha-2 (CA, US, JP)"
    },
    "agent": {
      "type": "string",
      "maxLength": 40,
      "description": "Name of the calling agent, for the merchant's records"
    },
    "client_request_id": {
      "type": "string",
      "minLength": 4,
      "maxLength": 120,
      "description": "Stable id for idempotent retries"
    }
  },
  "required": [
    "items",
    "ship_to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}