{"openapi":"3.1.0","info":{"title":"BabelNet (BYOK) API","version":"0.1.0","description":"BabelNet (BYOK) lets an AI assistant read your own BabelNet data through the BabelNet API with a key you supply (BabelNet API key (1000 queries per day on a free account)). Read-only: 6 tools (get_version, get_synset_ids, get_synset, get_senses, get_outgoing_edges, get_synset_ids_from_resource_id). The BYOK key travels with each request, is used for that one call only and is never stored, logged...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-babelnet.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-babelnet/docs"},"termsOfService":"https://connectorbay.com/byok-babelnet/terms"},"servers":[{"url":"https://byok-babelnet.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-babelnet/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_version":{"post":{"operationId":"get_version","summary":"Show which BabelNet version the API currently serves. Costs one query from the daily allowance. Use for \"Which BabelNet ","description":"Show which BabelNet version the API currently serves. Costs one query from the daily allowance. Use for \"Which BabelNet version is the API serving\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_versionArguments","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/get_synset_ids":{"post":{"operationId":"get_synset_ids","summary":"Find the ids of the BabelNet synsets (concepts) that a word can denote in a language, with part of speech and source. Co","description":"Find the ids of the BabelNet synsets (concepts) that a word can denote in a language, with part of speech and source. Costs one query. Use for \"Which BabelNet concepts can the English word 'apple' mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"lemma":{"description":"The word or phrase to look up, for example 'apple'.","maxLength":100,"title":"Lemma","type":"string"},"search_lang":{"description":"Language of the word as an upper-case code such as EN, IT, DE, FR, ES.","maxLength":10,"title":"Search Lang","type":"string"},"target_lang":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"One extra language (code such as IT) in which to return the data; English is returned by default.","title":"Target Lang"},"pos":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only return entries with this universal part of speech, for example NOUN, VERB, ADJ or ADV.","title":"Pos"}},"required":["lemma","search_lang"],"title":"get_synset_idsArguments","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/get_synset":{"post":{"operationId":"get_synset","summary":"Get one BabelNet synset: its glosses (definitions) in several languages, example sentences, type, domains and WordNet of","description":"Get one BabelNet synset: its glosses (definitions) in several languages, example sentences, type, domains and WordNet offsets. The long list of senses is left out; use get_senses for those. Costs one query. Use for \"Give me the definitions of BabelNet synset bn:03083790n\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"synset_id":{"description":"BabelNet synset id such as 'bn:03083790n' (a WordNet id starting with 'wn:' also works for get_synset).","maxLength":40,"title":"Synset Id","type":"string"},"target_lang":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"One extra language (code such as IT) in which to return glosses; English is returned by default.","title":"Target Lang"}},"required":["synset_id"],"title":"get_synsetArguments","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/get_senses":{"post":{"operationId":"get_senses","summary":"List the senses (lemma, language, part of speech, source and synset) of a word, for example the translations of a concep","description":"List the senses (lemma, language, part of speech, source and synset) of a word, for example the translations of a concept. Costs one query. Use for \"Show the BabelNet senses of the word 'BabelNet' in English\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"lemma":{"description":"The word or phrase to look up, for example 'apple'.","maxLength":100,"title":"Lemma","type":"string"},"search_lang":{"description":"Language of the word as an upper-case code such as EN, IT, DE, FR, ES.","maxLength":10,"title":"Search Lang","type":"string"},"target_lang":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"One extra language (code such as IT) in which to return the data; English is returned by default.","title":"Target Lang"},"pos":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only return entries with this universal part of speech, for example NOUN, VERB, ADJ or ADV.","title":"Pos"},"source":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only senses from this source, for example WIKT, WIKIDATA or WN.","title":"Source"}},"required":["lemma","search_lang"],"title":"get_sensesArguments","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/get_outgoing_edges":{"post":{"operationId":"get_outgoing_edges","summary":"List the relations that leave a synset (hypernym, hyponym, part-of and more) with relation name, group and the target sy","description":"List the relations that leave a synset (hypernym, hyponym, part-of and more) with relation name, group and the target synset id. Costs one query. Use for \"What is bn:03083790n an instance of in BabelNet\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"synset_id":{"description":"BabelNet synset id such as 'bn:03083790n' (a WordNet id starting with 'wn:' also works for get_synset).","maxLength":40,"title":"Synset Id","type":"string"}},"required":["synset_id"],"title":"get_outgoing_edgesArguments","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/get_synset_ids_from_resource_id":{"post":{"operationId":"get_synset_ids_from_resource_id","summary":"Map an identifier from another resource (a Wikipedia page title, a Wikidata id such as Q4837690, a WordNet id) to BabelN","description":"Map an identifier from another resource (a Wikipedia page title, a Wikidata id such as Q4837690, a WordNet id) to BabelNet synset ids. Costs one query. Use for \"Which BabelNet synset matches the Wikidata item Q4837690\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"resource_id":{"description":"Identifier in the other resource: a page title for WIKI, an item id for WIKIDATA.","maxLength":200,"title":"Resource Id","type":"string"},"source":{"description":"Which resource the identifier belongs to, for example WIKI, WIKIQU, WIKIDATA or WN.","maxLength":20,"title":"Source","type":"string"},"search_lang":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Language code (EN, IT ...); needed only for WIKI and WIKIQU page titles.","title":"Search Lang"},"pos":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only return entries with this universal part of speech, for example NOUN, VERB, ADJ or ADV.","title":"Pos"}},"required":["resource_id","source"],"title":"get_synset_ids_from_resource_idArguments","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}}}}