supplier-directory

Add a supplier to the directory and return its SUP-YYYY-NNNN number: the name, what they supply, who to contact and how, the payment terms, the lead time in days, and notes. Free tier: 10 suppliers; removing one you no longer use frees its slot.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 200,
      "description": "Who you buy from, e.g. Shenzhen Box Co, or Acme Fasteners"
    },
    "category": {
      "type": "string",
      "maxLength": 200,
      "description": "What they supply, e.g. Packaging, Raw materials, Print. Free-form; supplier_list filters on it"
    },
    "contact_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Your person there, e.g. Maria Chen"
    },
    "email": {
      "type": "string",
      "maxLength": 200,
      "description": "Orders or accounts email"
    },
    "phone": {
      "type": "string",
      "maxLength": 60,
      "description": "Phone number as you would dial it"
    },
    "website": {
      "type": "string",
      "maxLength": 400,
      "description": "Website or storefront URL"
    },
    "address": {
      "type": "string",
      "maxLength": 400,
      "description": "Postal or visiting address"
    },
    "payment_terms": {
      "type": "string",
      "maxLength": 200,
      "description": "The terms you buy on, e.g. Net 30, 50% upfront, Due on receipt"
    },
    "lead_time_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3650,
      "description": "Typical days from order to delivery, e.g. 14"
    },
    "notes": {
      "type": "string",
      "maxLength": 2000,
      "description": "Anything worth remembering: minimum orders, who to escalate to, why you dropped them last time"
    }
  },
  "required": [
    "name",
    "category"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the supplier directory A to Z by name: contact, payment terms, lead time, when each record was last reviewed and how many days ago that was. Filter by category and by free text across every field. Reads only.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "maxLength": 200,
      "description": "Only suppliers in exactly this category, case-insensitive"
    },
    "q": {
      "type": "string",
      "maxLength": 200,
      "description": "Only suppliers whose name, category, contact, terms or notes contain this text, case-insensitive"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read one supplier record in full by SUP number or name: every contact field, the payment terms, the lead time, the notes, and when the record was last reviewed. Reads only.

{
  "type": "object",
  "properties": {
    "supplier": {
      "type": "string",
      "maxLength": 200,
      "description": "The supplier id, e.g. SUP-2026-0003, or the name when only one supplier has it"
    }
  },
  "required": [
    "supplier"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Change any of a supplier's fields by SUP number or name: name, category, the contact fields, payment terms, lead time, notes. Only the fields you pass change; pass at least one. The SUP number and the review stamp are not writable here -- supplier_mark_reviewed does the stamp.

{
  "type": "object",
  "properties": {
    "supplier": {
      "type": "string",
      "maxLength": 200,
      "description": "The supplier id, e.g. SUP-2026-0003, or the name when only one supplier has it"
    },
    "name": {
      "type": "string",
      "maxLength": 200,
      "description": "Rename the supplier"
    },
    "category": {
      "type": "string",
      "maxLength": 200,
      "description": "What they supply, e.g. Packaging, Raw materials, Print. Free-form; supplier_list filters on it"
    },
    "contact_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Your person there, e.g. Maria Chen"
    },
    "email": {
      "type": "string",
      "maxLength": 200,
      "description": "Orders or accounts email"
    },
    "phone": {
      "type": "string",
      "maxLength": 60,
      "description": "Phone number as you would dial it"
    },
    "website": {
      "type": "string",
      "maxLength": 400,
      "description": "Website or storefront URL"
    },
    "address": {
      "type": "string",
      "maxLength": 400,
      "description": "Postal or visiting address"
    },
    "payment_terms": {
      "type": "string",
      "maxLength": 200,
      "description": "The terms you buy on, e.g. Net 30, 50% upfront, Due on receipt"
    },
    "lead_time_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3650,
      "description": "Typical days from order to delivery, e.g. 14"
    },
    "notes": {
      "type": "string",
      "maxLength": 2000,
      "description": "Anything worth remembering: minimum orders, who to escalate to, why you dropped them last time"
    }
  },
  "required": [
    "supplier"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Remove a supplier from the directory by SUP number or name, returning the record as it stood so nothing is lost silently. The SUP number is never reissued. On the free tier the slot is freed for another supplier.

{
  "type": "object",
  "properties": {
    "supplier": {
      "type": "string",
      "maxLength": 200,
      "description": "The supplier id, e.g. SUP-2026-0003, or the name when only one supplier has it"
    }
  },
  "required": [
    "supplier"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Stamp a supplier's record as reviewed on a date, today by default: you have checked the contact, the terms and the lead time are still true. This is the stamp supplier_due_review reads, so a reviewed record stops being flagged as stale.

{
  "type": "object",
  "properties": {
    "supplier": {
      "type": "string",
      "maxLength": 200,
      "description": "The supplier id, e.g. SUP-2026-0003, or the name when only one supplier has it"
    },
    "date": {
      "type": "string",
      "maxLength": 10,
      "description": "The date you reviewed the record, YYYY-MM-DD. Default today"
    }
  },
  "required": [
    "supplier"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The due-review report: every supplier whose record has not been reviewed in the last N days -- 90 unless you say otherwise -- most overdue first. A record never reviewed is always due, whatever its age. This is the report that keeps the directory from rotting. Pro feature.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3650,
      "description": "A record is due when its last review is older than this many days. Default 90"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Export the supplier directory as CSV or a Markdown table: every field, one row per supplier, A to Z by name. CSV opens in any spreadsheet; Markdown drops into a doc, a wiki or a README. Filter by category and free text first if you only want part of it. CSV is free; Markdown is Pro.

{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": [
        "csv",
        "markdown"
      ],
      "description": "csv (default) or markdown"
    },
    "category": {
      "type": "string",
      "maxLength": 200,
      "description": "Only suppliers in exactly this category, case-insensitive"
    },
    "q": {
      "type": "string",
      "maxLength": 200,
      "description": "Only suppliers whose fields contain this text, case-insensitive"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "License key from checkout, MCPL1.<payload>.<signature>"
    }
  },
  "required": [
    "key"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}