{"openapi":"3.1.0","info":{"title":"B2BNegotiate API","version":"0.1.0","description":"A fully local B2B contract-negotiation preparation toolkit: BATNA/ZOPA explainers and a ZOPA calculator, a contract-terms glossary, a transparent leverage self-assessment, a prep checklist, and a negotiation glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://b2bnegotiate.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/b2bnegotiate/docs"},"termsOfService":"https://connectorbay.com/b2bnegotiate/terms"},"servers":[{"url":"https://b2bnegotiate.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/b2bnegotiate/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/batna_guide":{"post":{"operationId":"batna_guide","summary":"Explains BATNA (Best Alternative To a Negotiated Agreement) — what it is, why it's the single biggest","description":"Explains BATNA (Best Alternative To a Negotiated Agreement) — what it is, why it's the single biggest\n    lever in any negotiation, a worked numeric example, and how to build a real one. Use for \"what's a BATNA\",\n    \"how do I figure out my BATNA before negotiating a contract\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"batna_guideArguments","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/zopa_guide":{"post":{"operationId":"zopa_guide","summary":"Explains ZOPA (Zone Of Possible Agreement) — the overlap between a buyer's max and a seller's min where","description":"Explains ZOPA (Zone Of Possible Agreement) — the overlap between a buyer's max and a seller's min where\n    a deal is possible — how to estimate it, and a worked example. Use for \"what's a ZOPA\", \"how do I estimate\n    the zone of possible agreement\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"zopa_guideArguments","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/zopa_estimator":{"post":{"operationId":"zopa_estimator","summary":"Given a seller's minimum acceptable price and a buyer's maximum acceptable price, computes whether a","description":"Given a seller's minimum acceptable price and a buyer's maximum acceptable price, computes whether a\n    ZOPA exists, and if so its range and midpoint; if not, the gap between the two. Use for \"is there a deal\n    possible if the seller wants at least $100k and the buyer will only pay $90k\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"seller_min_acceptable":{"description":"The seller's lowest acceptable price (their reservation price).","title":"Seller Min Acceptable","type":"number"},"buyer_max_acceptable":{"description":"The buyer's highest acceptable price (their reservation price).","title":"Buyer Max Acceptable","type":"number"}},"required":["seller_min_acceptable","buyer_max_acceptable"],"title":"zopa_estimatorArguments","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/contract_terms_glossary":{"post":{"operationId":"contract_terms_glossary","summary":"Explains common B2B contract terms worth negotiating deliberately — payment terms, SLA/service-level","description":"Explains common B2B contract terms worth negotiating deliberately — payment terms, SLA/service-level\n    commitments, liability caps, termination clauses, exclusivity — each with what it means and a typical\n    negotiation angle for each side. Use for \"what should I know about liability caps\", \"how do termination\n    clauses usually work in B2B contracts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"One of: payment terms, SLA / service-level commitments, liability caps, termination clauses, exclusivity. Omit to list all.","title":"Term"}},"title":"contract_terms_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}},"/v1/tools/leverage_assessment":{"post":{"operationId":"leverage_assessment","summary":"A transparent, rough leverage-position indicator: scores alternative-supplier availability, each","description":"A transparent, rough leverage-position indicator: scores alternative-supplier availability, each\n    party's relative dependence on the deal, and time pressure on each side, and returns a total score, a\n    plain-language band, and a full points breakdown so the number is checkable, not a black box. Use for \"who\n    has more leverage in this negotiation\", \"do I have a strong hand going into this deal\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"alternative_suppliers_available":{"description":"How many other viable counterparties you could realistically do this deal with instead.","maximum":50,"minimum":0,"title":"Alternative Suppliers Available","type":"integer"},"deal_size_pct_of_your_business":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"This deal's approximate size as a percent of your own business (revenue, budget, or spend). Omit if unknown.","title":"Deal Size Pct Of Your Business"},"deal_size_pct_of_their_business":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"This deal's approximate size as a percent of the counterparty's business. Omit if unknown.","title":"Deal Size Pct Of Their Business"},"time_pressure_you":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"low | medium | high — how much time pressure you're under to close.","title":"Time Pressure You"},"time_pressure_them":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"low | medium | high — how much time pressure the counterparty is under to close.","title":"Time Pressure Them"}},"required":["alternative_suppliers_available"],"title":"leverage_assessmentArguments","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/negotiation_prep_checklist":{"post":{"operationId":"negotiation_prep_checklist","summary":"A step-by-step checklist for preparing to negotiate a B2B contract — objectives, BATNA, estimating the","description":"A step-by-step checklist for preparing to negotiate a B2B contract — objectives, BATNA, estimating the\n    counterparty's BATNA, ZOPA, leverage, key non-price terms, opening anchor, concession plan, decision\n    authority, and walk-away point. Use for \"how do I prepare for a contract negotiation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"negotiation_prep_checklistArguments","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/negotiation_glossary":{"post":{"operationId":"negotiation_glossary","summary":"Definitions of common negotiation terms — BATNA, ZOPA, reservation price, anchoring, concession,","description":"Definitions of common negotiation terms — BATNA, ZOPA, reservation price, anchoring, concession,\n    distributive vs. integrative negotiation, package deal, most-favored-nation clause, walk-away point. Use\n    for \"what does anchoring mean in negotiation\", \"what's the difference between distributive and integrative\n    negotiation\".","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":"negotiation_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}}}}