{"openapi":"3.1.0","info":{"title":"License API","version":"0.1.0","description":"A fully local open-source license reference: SPDX-derived lookup/search, a hand-curated comparison matrix, license-choice guidance, best-effort compatibility notes, OSI/copyleft filters, badge snippets and a glossary. General information, not legal advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://license.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/license/docs"},"termsOfService":"https://connectorbay.com/license/terms"},"servers":[{"url":"https://license.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/license/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/license_lookup":{"post":{"operationId":"license_lookup","summary":"Full detail for one license: SPDX id, full name, OSI-approved and FSF-libre flags, a plain-English one-","description":"Full detail for one license: SPDX id, full name, OSI-approved and FSF-libre flags, a plain-English one-\n    paragraph summary (in our own words -- never the license's own legal text) of what it permits and requires,\n    and the canonical reference URL for the real legal text. Use for \"what license is MIT\", \"tell me about the\n    GPL-3.0 license\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"spdx_id_or_name":{"description":"An SPDX license id (e.g. 'MIT', 'GPL-3.0-only'), a common alias ('GPLv3', 'Apache 2'), or a full license name.","title":"Spdx Id Or Name","type":"string"}},"required":["spdx_id_or_name"],"title":"license_lookupArguments","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/license_search":{"post":{"operationId":"license_search","summary":"Search the full SPDX license list by id or name keyword. Use for \"find licenses with 'commons' in the","description":"Search the full SPDX license list by id or name keyword. Use for \"find licenses with 'commons' in the\n    name\", \"what BSD variants exist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search license ids and names for, e.g. 'creative commons', 'BSD', 'public domain'.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"license_searchArguments","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/compare_licenses":{"post":{"operationId":"compare_licenses","summary":"A plain-language, hand-curated comparison table between two licenses across key dimensions: commercial","description":"A plain-language, hand-curated comparison table between two licenses across key dimensions: commercial\n    use, modification, distribution, patent grant, copyleft strength (none/weak/strong/network), must-disclose-\n    source, same-license-required, trademark use, and liability/warranty disclaimer. Covers the ~25 most common\n    licenses (see comparable_ids in the error if a license isn't covered). Use for \"compare MIT and GPL-3.0\",\n    \"how does Apache-2.0 differ from BSD-3-Clause\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"spdx_id_a":{"description":"First license's SPDX id or common name.","title":"Spdx Id A","type":"string"},"spdx_id_b":{"description":"Second license's SPDX id or common name.","title":"Spdx Id B","type":"string"}},"required":["spdx_id_a","spdx_id_b"],"title":"compare_licensesArguments","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/choose_a_license":{"post":{"operationId":"choose_a_license","summary":"Given a list of priorities, suggest 2-3 candidate licenses with reasoning, drawn from the comparison","description":"Given a list of priorities, suggest 2-3 candidate licenses with reasoning, drawn from the comparison\n    matrix. Always ends with a reminder this is not legal advice. Use for \"what license should I use for a\n    permissive library with patent protection\", \"I want a copyleft license that closes the SaaS loophole\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"priorities":{"description":"Priorities such as 'permissive', 'copyleft', 'share-alike', 'patent-protection', 'public-domain', 'weak-copyleft', 'network-use', 'attribution', 'content', 'font'.","items":{"type":"string"},"title":"Priorities","type":"array"}},"required":["priorities"],"title":"choose_a_licenseArguments","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/is_compatible":{"post":{"operationId":"is_compatible","summary":"A best-effort, clearly-caveated compatibility note for combining code under two licenses (e.g. can MIT","description":"A best-effort, clearly-caveated compatibility note for combining code under two licenses (e.g. can MIT\n    code go into a GPL project). Conservative by design: for pairs we're not confident about, it says to check\n    a lawyer or the FSF/SPDX compatibility notes rather than guessing. Use for \"can I use MIT code in a GPL\n    project\", \"are GPL-2.0 and GPL-3.0 compatible\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"spdx_id_a":{"description":"First license's SPDX id or common name.","title":"Spdx Id A","type":"string"},"spdx_id_b":{"description":"Second license's SPDX id or common name.","title":"Spdx Id B","type":"string"}},"required":["spdx_id_a","spdx_id_b"],"title":"is_compatibleArguments","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/osi_approved_list":{"post":{"operationId":"osi_approved_list","summary":"The list of OSI-approved (or, with only_osi=false, all non-deprecated SPDX) licenses. Use for \"list OSI-","description":"The list of OSI-approved (or, with only_osi=false, all non-deprecated SPDX) licenses. Use for \"list OSI-\n    approved licenses\", \"is this license OSI approved\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"only_osi":{"default":true,"description":"If true (default), return only OSI-approved licenses; if false, return the full non-deprecated SPDX list with the osi_approved flag on each.","title":"Only Osi","type":"boolean"}},"title":"osi_approved_listArguments","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/copyleft_list":{"post":{"operationId":"copyleft_list","summary":"Licenses grouped by copyleft strength (none, weak, strong, network), from the hand-curated comparison","description":"Licenses grouped by copyleft strength (none, weak, strong, network), from the hand-curated comparison\n    matrix. Use for \"list strong copyleft licenses\", \"what weak copyleft licenses exist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"strength":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"none | weak | strong | network; omit to return all groups.","title":"Strength"}},"title":"copyleft_listArguments","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/license_badge_snippet":{"post":{"operationId":"license_badge_snippet","summary":"A shields.io-style badge snippet referencing a license, in markdown, HTML, RST, or as a plain image URL.","description":"A shields.io-style badge snippet referencing a license, in markdown, HTML, RST, or as a plain image URL.\n    Pure string templating -- no network call is made. Use for \"give me a license badge for my README\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"spdx_id":{"description":"SPDX license id or common name.","title":"Spdx Id","type":"string"},"style":{"default":"markdown","description":"markdown (default) | html | rst | url","title":"Style","type":"string"}},"required":["spdx_id"],"title":"license_badge_snippetArguments","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/license_glossary":{"post":{"operationId":"license_glossary","summary":"Definitions of common open-source licensing terms (copyleft, permissive, patent grant, share-alike, dual","description":"Definitions of common open-source licensing terms (copyleft, permissive, patent grant, share-alike, dual\n    licensing, SPDX identifier, OSI-approved, and more). Use for \"what does copyleft mean\", \"what's a patent\n    grant\".","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":"license_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}}}}