Supplier List

Working · 23 ms

io.github.theluckystrike/supplier-listv0.22.6

A supplier directory that does not rot: contacts, terms, lead times, review dates.

Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.zovo.one/mcp/supplier-list

Authorization (required)

Bearer <Pro license key or anonymous token from GET https://mcp.zovo.one/mcp/token>

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

license_activate

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.

keystring, required

License key from checkout, MCPL1.<payload>.<signature>

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (10)

license_activate

Argument	Type	Description
key*	string	License key from checkout, MCPL1.<payload>.<signature>

Input schema (JSON)

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

license_status

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.

read-only

No arguments.

Input schema (JSON)

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

supplier_add

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.

Argument	Type	Description
name*	string	Who you buy from, e.g. Shenzhen Box Co, or Acme Fasteners
email	string	Orders or accounts email
notes	string	Anything worth remembering: minimum orders, who to escalate to, why you dropped them last time
phone	string	Phone number as you would dial it
address	string	Postal or visiting address
website	string	Website or storefront URL
category*	string	What they supply, e.g. Packaging, Raw materials, Print. Free-form; supplier_list filters on it
contact_name	string	Your person there, e.g. Maria Chen
payment_terms	string	The terms you buy on, e.g. Net 30, 50% upfront, Due on receipt

supplier_due_review

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.

Argument	Type	Description
days	integer	A record is due when its last review is older than this many days. Default 90

Input schema (JSON)

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

supplier_export

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.

read-only

Argument	Type	Description
q	string	Only suppliers whose fields contain this text, case-insensitive
format	string	csv (default) or markdown
category	string	Only suppliers in exactly this category, case-insensitive

Input schema (JSON)

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

supplier_get

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.

read-only

Argument	Type	Description
supplier*	string	The supplier id, e.g. SUP-2026-0003, or the name when only one supplier has it

Input schema (JSON)

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

supplier_list

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.

read-only

Argument	Type	Description
q	string	Only suppliers whose name, category, contact, terms or notes contain this text, case-insensitive
category	string	Only suppliers in exactly this category, case-insensitive

Input schema (JSON)

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

supplier_mark_reviewed

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.

Argument	Type	Description
date	string	The date you reviewed the record, YYYY-MM-DD. Default today
supplier*	string	The supplier id, e.g. SUP-2026-0003, or the name when only one supplier has it

Input schema (JSON)

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

supplier_remove

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.

destructive

Argument	Type	Description
supplier*	string	The supplier id, e.g. SUP-2026-0003, or the name when only one supplier has it

Input schema (JSON)

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

supplier_update

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.

Argument	Type	Description
name	string	Rename the supplier
email	string	Orders or accounts email
notes	string	Anything worth remembering: minimum orders, who to escalate to, why you dropped them last time
phone	string	Phone number as you would dial it
address	string	Postal or visiting address
website	string	Website or storefront URL
category	string	What they supply, e.g. Packaging, Raw materials, Print. Free-form; supplier_list filters on it
supplier*	string	The supplier id, e.g. SUP-2026-0003, or the name when only one supplier has it
contact_name	string	Your person there, e.g. Maria Chen