{"openapi":"3.1.0","info":{"title":"Wordnik (BYOK) API","version":"0.1.0","description":"Wordnik (BYOK) lets an AI assistant read your own Wordnik data through the Wordnik API with a key you supply (Wordnik API key). Read-only: 12 tools (get_definitions, get_examples, get_top_example, get_related_words, get_pronunciations, get_hyphenation, get_etymologies, get_word_frequency, get_phrases, search_words, get_random_words, get_word_of_the_day). The BYOK key travels with each request, is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-wordnik.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-wordnik/docs"},"termsOfService":"https://connectorbay.com/byok-wordnik/terms"},"servers":[{"url":"https://byok-wordnik.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-wordnik/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_definitions":{"post":{"operationId":"get_definitions","summary":"Get dictionary definitions of an English word from five source dictionaries, with part of speech and the attribution tex","description":"Get dictionary definitions of an English word from five source dictionaries, with part of speech and the attribution text that must be shown with each. Use for \"What does 'serendipity' mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Maximum number of definitions to return (1 to 50).","title":"Limit"},"part_of_speech":{"anyOf":[{"enum":["noun","adjective","verb","adverb","interjection","pronoun","preposition","abbreviation","affix","article","auxiliary-verb","conjunction","definite-article","idiom","noun-plural","past-participle","proper-noun","suffix","verb-intransitive","verb-transitive"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this part of speech.","title":"Part Of Speech"},"source_dictionaries":{"anyOf":[{"enum":["all","ahd-5","century","wiktionary","webster","wordnet"],"type":"string"},{"type":"null"}],"default":null,"description":"Source dictionary to use (one value; 'all' for every dictionary).","title":"Source Dictionaries"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_definitionsArguments","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_examples":{"post":{"operationId":"get_examples","summary":"Get real example sentences that use a word, with the title and link of the source. Use for \"Show example sentences with ","description":"Get real example sentences that use a word, with the title and link of the source. Use for \"Show example sentences with the word 'ephemeral'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":5,"description":"Maximum number of examples to return (1 to 50).","title":"Limit"},"skip":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Skip"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_examplesArguments","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_top_example":{"post":{"operationId":"get_top_example","summary":"Get the single best example sentence for a word. Use for \"Give me one good example sentence for 'ubiquitous'\".","description":"Get the single best example sentence for a word. Use for \"Give me one good example sentence for 'ubiquitous'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_top_exampleArguments","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_related_words":{"post":{"operationId":"get_related_words","summary":"Get synonyms, antonyms, rhymes, hypernyms and other related words for a word, grouped by relationship type. Use for \"Wha","description":"Get synonyms, antonyms, rhymes, hypernyms and other related words for a word, grouped by relationship type. Use for \"What are the synonyms and antonyms of 'happy'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"relationship_types":{"anyOf":[{"enum":["synonym","antonym","variant","equivalent","cross-reference","related-word","rhyme","form","etymologically-related-term","hypernym","hyponym","inflected-form","primary","same-context","verb-form","verb-stem","has_topic"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this relationship type (one value).","title":"Relationship Types"},"limit_per_relationship_type":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Maximum words per relationship type (1 to 100).","title":"Limit Per Relationship Type"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_related_wordsArguments","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_pronunciations":{"post":{"operationId":"get_pronunciations","summary":"Get text pronunciations of a word (IPA, ARPABET and other notations). Use for \"How do I pronounce 'colonel'\".","description":"Get text pronunciations of a word (IPA, ARPABET and other notations). Use for \"How do I pronounce 'colonel'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"type_format":{"anyOf":[{"enum":["ahd-5","arpabet","gcide-diacritical","IPA"],"type":"string"},{"type":"null"}],"default":null,"description":"Notation: ahd-5, arpabet, gcide-diacritical or IPA.","title":"Type Format"},"source_dictionary":{"anyOf":[{"enum":["ahd-5","century","cmu","macmillan","wiktionary","webster","wordnet"],"type":"string"},{"type":"null"}],"default":null,"description":"Take pronunciations from one dictionary only.","title":"Source Dictionary"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Maximum number of pronunciations to return (1 to 50).","title":"Limit"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_pronunciationsArguments","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_hyphenation":{"post":{"operationId":"get_hyphenation","summary":"Split a word into syllables. Use for \"How many syllables does 'encyclopedia' have\".","description":"Split a word into syllables. Use for \"How many syllables does 'encyclopedia' have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"source_dictionary":{"anyOf":[{"enum":["ahd-5","century","wiktionary","webster","wordnet"],"type":"string"},{"type":"null"}],"default":null,"description":"Take syllables from one dictionary only.","title":"Source Dictionary"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Maximum number of syllables to return (1 to 50).","title":"Limit"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_hyphenationArguments","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_etymologies":{"post":{"operationId":"get_etymologies","summary":"Get the origin (etymology) text of a word. Use for \"Where does the word 'quarantine' come from\".","description":"Get the origin (etymology) text of a word. Use for \"Where does the word 'quarantine' come from\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_etymologiesArguments","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_word_frequency":{"post":{"operationId":"get_word_frequency","summary":"Get how often a word was used per year in the Wordnik corpus between two years. Use for \"How has the use of the word 'te","description":"Get how often a word was used per year in the Wordnik corpus between two years. Use for \"How has the use of the word 'telegraph' changed since 1850\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"start_year":{"anyOf":[{"maximum":2100,"minimum":1500,"type":"integer"},{"type":"null"}],"default":1800,"description":"First year, default 1800.","title":"Start Year"},"end_year":{"anyOf":[{"maximum":2100,"minimum":1500,"type":"integer"},{"type":"null"}],"default":2012,"description":"Last year, default 2012.","title":"End Year"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_word_frequencyArguments","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_phrases":{"post":{"operationId":"get_phrases","summary":"Get common two-word phrases (bigrams) that contain a word. Use for \"Which phrases commonly include 'rainy'\".","description":"Get common two-word phrases (bigrams) that contain a word. Use for \"Which phrases commonly include 'rainy'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up, for example 'serendipity'.","maxLength":200,"title":"Word","type":"string"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":5,"description":"Maximum number of phrases to return (1 to 50).","title":"Limit"},"min_wlmi":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Minimum WLMI score of a phrase.","title":"Min Wlmi"},"use_canonical":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to look up the root form of the word ('cats' becomes 'cat'); false to use the word as written.","title":"Use Canonical"}},"required":["word"],"title":"get_phrasesArguments","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/search_words":{"post":{"operationId":"search_words","summary":"Search the word list for words matching a pattern; set allow_regex for a regular expression. Filters by length and corpu","description":"Search the word list for words matching a pattern; set allow_regex for a regular expression. Filters by length and corpus frequency. Use for \"Find words that start with 'quiz' and are 8 letters long\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Search text, for example 'quiz' (a regular expression when allow_regex is true).","maxLength":100,"title":"Query","type":"string"},"allow_regex":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to treat the query as a regular expression.","title":"Allow Regex"},"case_sensitive":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True for a case-sensitive search.","title":"Case Sensitive"},"min_length":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Minimum word length.","title":"Min Length"},"max_length":{"anyOf":[{"maximum":50,"minimum":-1,"type":"integer"},{"type":"null"}],"default":-1,"description":"Maximum word length (-1 for no limit).","title":"Max Length"},"min_corpus_count":{"anyOf":[{"maximum":100000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":5,"description":"Minimum corpus frequency of the word.","title":"Min Corpus Count"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Maximum number of results to return (1 to 100).","title":"Limit"},"skip":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip, for paging.","title":"Skip"}},"required":["query"],"title":"search_wordsArguments","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_random_words":{"post":{"operationId":"get_random_words","summary":"Get random English words, optionally with a length range and part of speech. Use for \"Give me 5 random nouns with at lea","description":"Get random English words, optionally with a length range and part of speech. Use for \"Give me 5 random nouns with at least 7 letters\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"has_dictionary_def":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to return only words that have a dictionary definition.","title":"Has Dictionary Def"},"include_part_of_speech":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated parts of speech to include, for example 'noun,verb'.","title":"Include Part Of Speech"},"min_length":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":5,"description":"Minimum word length.","title":"Min Length"},"max_length":{"anyOf":[{"maximum":50,"minimum":-1,"type":"integer"},{"type":"null"}],"default":-1,"description":"Maximum word length (-1 for no limit).","title":"Max Length"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Maximum number of results to return (1 to 100).","title":"Limit"}},"title":"get_random_wordsArguments","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_word_of_the_day":{"post":{"operationId":"get_word_of_the_day","summary":"Get Wordnik's word of the day for a date (today if omitted), with definitions, examples and a note. Use for \"What is the","description":"Get Wordnik's word of the day for a date (today if omitted), with definitions, examples and a note. Use for \"What is the Wordnik word of the day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Date as yyyy-MM-dd, for example 2026-10-17. Default today.","title":"Date"}},"title":"get_word_of_the_dayArguments","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}}}}