{"openapi":"3.1.0","info":{"title":"VendorCompare API","version":"0.1.0","description":"Vendor/supplier-comparison scorecard: a real weighted-sum calculator over caller-supplied scores with custom or default weights, plus a vendor-evaluation-criteria reference and glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://vendorcompare.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/vendorcompare/docs"},"termsOfService":"https://connectorbay.com/vendorcompare/terms"},"servers":[{"url":"https://vendorcompare.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/vendorcompare/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/vendor_scorecard":{"post":{"operationId":"vendor_scorecard","summary":"Real weighted-sum scorecard total for each vendor and a rank order, using documented default weights or","description":"Real weighted-sum scorecard total for each vendor and a rank order, using documented default weights or\n    your own custom weights (normalized to sum to 1.0). Use for \"compare these vendors on price, quality, and\n    lead time\", \"which vendor wins if reliability is weighted more heavily\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vendors":{"description":"Each vendor: {name: str, scores: {price, quality, reliability, lead_time, payment_terms}} — all five scores required, any consistent numeric scale (e.g. 0-10, higher is better).","examples":[[{"name":"Acme Supply","scores":{"lead_time":5,"payment_terms":8,"price":9,"quality":6,"reliability":7}},{"name":"Beta Parts","scores":{"lead_time":7,"payment_terms":6,"price":6,"quality":9,"reliability":8}}]],"items":{"additionalProperties":true,"type":"object"},"minItems":1,"title":"Vendors","type":"array"},"weights":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"default":null,"description":"Optional custom weights for the same five criteria (any positive numbers — normalized automatically). Omit to use the documented default weights.","title":"Weights"}},"required":["vendors"],"title":"vendor_scorecardArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/default_weights":{"post":{"operationId":"default_weights","summary":"The documented default scorecard weights (price 30%, quality 25%, reliability 20%, lead_time 15%,","description":"The documented default scorecard weights (price 30%, quality 25%, reliability 20%, lead_time 15%,\n    payment_terms 10%) and the rationale behind them. Use for \"what are the default vendor scorecard weights\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"default_weightsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/vendor_evaluation_criteria_reference":{"post":{"operationId":"vendor_evaluation_criteria_reference","summary":"What to weigh in a vendor/supplier decision beyond price — total cost of ownership, financial","description":"What to weigh in a vendor/supplier decision beyond price — total cost of ownership, financial\n    stability, quality certifications, reliability history, capacity to scale, single-source risk, payment\n    terms, communication, contract/exit terms, compliance, references. Use for \"what should I consider besides\n    price when picking a vendor\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"vendor_evaluation_criteria_referenceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/vendor_glossary":{"post":{"operationId":"vendor_glossary","summary":"Definitions of vendor-management terms (weighted scorecard, total cost of ownership, single-source","description":"Definitions of vendor-management terms (weighted scorecard, total cost of ownership, single-source\n    risk, lead time, payment terms, vendor lock-in, SLA, RFQ vs. RFP, force majeure clause). Use for \"what's an\n    SLA\", \"what's the difference between an RFQ and an RFP\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"vendor_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}