{"openapi":"3.1.0","info":{"title":"Lexicon API","version":"0.1.0","description":"Dictionary, thesaurus, rhymes, word finder, anagrams, spelling, etymology, translations of terms, readability — the English word toolkit.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://lexicon.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/lexicon/docs"},"termsOfService":"https://connectorbay.com/lexicon/terms"},"servers":[{"url":"https://lexicon.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/lexicon/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/define":{"post":{"operationId":"define","summary":"Define a word: pronunciation (IPA + audio), meanings grouped by part of speech with example sentences, synonyms and","description":"Define a word: pronunciation (IPA + audio), meanings grouped by part of speech with example sentences, synonyms and\n    antonyms, and the source page. English via the Free Dictionary API with Wiktionary as fallback; other languages via\n    Wiktionary. Use for \"what does X mean\", \"define X\", \"X meaning\", \"is X a noun or a verb\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word or short phrase to define.","examples":["serendipity","run","take off"],"title":"Word","type":"string"},"language":{"default":"en","description":"Language of the word as a Wiktionary code: en, es, fr, de, it, pt, la, hi… Default en.","examples":["en"],"title":"Language","type":"string"}},"required":["word"],"title":"defineArguments","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/pronunciation":{"post":{"operationId":"pronunciation","summary":"How to say a word: IPA transcription, ARPAbet phonemes, syllable count, audio clips (US/UK) and a plain","description":"How to say a word: IPA transcription, ARPAbet phonemes, syllable count, audio clips (US/UK) and a plain\n    respelling hint. Use for \"how do you pronounce X\", \"how many syllables in X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"An English word.","examples":["quinoa","colonel"],"title":"Word","type":"string"}},"required":["word"],"title":"pronunciationArguments","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/thesaurus":{"post":{"operationId":"thesaurus","summary":"Thesaurus and word relations from Datamuse: synonyms, antonyms, semantically related words, broader/narrower terms","description":"Thesaurus and word relations from Datamuse: synonyms, antonyms, semantically related words, broader/narrower terms\n    (hypernyms/hyponyms), parts and wholes, adjectives commonly used with a noun (or nouns for an adjective), words that\n    typically follow/precede, sound-alikes and homophones. Each result has parts of speech, frequency and a short gloss\n    where available. Use for \"another word for X\", \"opposite of X\", \"adjectives for coffee\", \"what's more general than X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to look up.","examples":["happy","car","run"],"title":"Word","type":"string"},"relation":{"default":"synonyms","description":"synonyms | antonyms | related | broader | narrower | part_of | has_parts | triggers | adjectives (for a noun) | nouns (for an adjective) | follows | precedes | sounds_like | homophones | consonant_match.","examples":["synonyms","antonyms","adjectives"],"title":"Relation","type":"string"},"max_results":{"default":20,"description":"1–100.","maximum":100,"minimum":1,"title":"Max Results","type":"integer"}},"required":["word"],"title":"thesaurusArguments","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/rhymes":{"post":{"operationId":"rhymes","summary":"Rhymes for a word — perfect rhymes or near (slant) rhymes — with syllable counts and word frequency, optionally","description":"Rhymes for a word — perfect rhymes or near (slant) rhymes — with syllable counts and word frequency, optionally\n    filtered to a syllable count. Use for songwriting, poetry, \"what rhymes with X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"The word to rhyme.","examples":["orange","love","time"],"title":"Word","type":"string"},"kind":{"default":"perfect","description":"'perfect' (same ending sound) or 'near' (slant/approximate rhymes).","examples":["perfect"],"title":"Kind","type":"string"},"syllables":{"anyOf":[{"maximum":8,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only rhymes with this many syllables.","title":"Syllables"},"max_results":{"default":30,"description":"1–100.","maximum":100,"minimum":1,"title":"Max Results","type":"integer"}},"required":["word"],"title":"rhymesArguments","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/word_finder":{"post":{"operationId":"word_finder","summary":"Find words by pattern and/or meaning: crossword fills ('c?a??'), Wordle candidates (pattern + must-contain + excluded","description":"Find words by pattern and/or meaning: crossword fills ('c?a??'), Wordle candidates (pattern + must-contain + excluded\n    letters), prefix/suffix/length searches, or \"words that mean X starting with Y\". Pattern-only searches run against the\n    bundled ENABLE list (offline); meaning searches use Datamuse and include a gloss. Use for \"5-letter words starting with\n    s ending in e\", \"words for 'brave' that start with v\", \"what fits _a_e_\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"pattern":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Letter pattern: '?' = one unknown letter, '*' = any run. 'c?a??' (5 letters), 'un*able', '???'.","examples":["c?a??","un*able"],"title":"Pattern"},"means_like":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Meaning constraint: the results should mean roughly this.","examples":["happy","large house"],"title":"Means Like"},"starts_with":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Required prefix.","title":"Starts With"},"ends_with":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Required suffix.","title":"Ends With"},"length":{"anyOf":[{"maximum":30,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Exact word length.","title":"Length"},"must_contain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Letters that must appear somewhere (Wordle yellows).","examples":["ae"],"title":"Must Contain"},"exclude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Letters that must not appear (Wordle greys).","examples":["rstln"],"title":"Exclude"},"max_results":{"default":40,"description":"1–200.","maximum":200,"minimum":1,"title":"Max Results","type":"integer"}},"title":"word_finderArguments","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/anagrams":{"post":{"operationId":"anagrams","summary":"Words that can be made from a set of letters (each letter used once; '?' is a blank), longest and highest-scoring","description":"Words that can be made from a set of letters (each letter used once; '?' is a blank), longest and highest-scoring\n    first, with full anagrams listed separately and Scrabble scores. Also tells you whether a single word is valid in the\n    word list. Use for Scrabble/Words With Friends racks, anagram puzzles, \"what words can I make from X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"letters":{"description":"Letters available, e.g. a Scrabble rack; '?' for a blank tile.","examples":["retains","aeinrst?"],"title":"Letters","type":"string"},"min_length":{"default":3,"description":"Shortest word to return.","maximum":15,"minimum":2,"title":"Min Length","type":"integer"},"max_results":{"default":60,"description":"1–200.","maximum":200,"minimum":1,"title":"Max Results","type":"integer"}},"required":["letters"],"title":"anagramsArguments","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/spell_check":{"post":{"operationId":"spell_check","summary":"Check spelling of a word or passage: flags words not in the dictionary and proposes corrections (Wiktionary's","description":"Check spelling of a word or passage: flags words not in the dictionary and proposes corrections (Wiktionary's\n    'misspelling of' data plus closest dictionary words). Proper nouns and rare terms may be flagged — say so. Use for\n    \"is X spelled right\", \"check this for typos\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"description":"A word, or a sentence/paragraph up to ~300 words.","examples":["definately recieve","I beleive the acommodation was seperate."],"title":"Text","type":"string"}},"required":["text"],"title":"spell_checkArguments","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/etymology":{"post":{"operationId":"etymology","summary":"Where a word comes from: the Etymology section(s) of its English Wiktionary entry as plain text (one per sense,","description":"Where a word comes from: the Etymology section(s) of its English Wiktionary entry as plain text (one per sense,\n    when the word has several origins). Use for \"origin of the word X\", \"why is it called X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"word":{"description":"An English word.","examples":["salary","quarantine","avocado"],"title":"Word","type":"string"}},"required":["word"],"title":"etymologyArguments","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/term_in_languages":{"post":{"operationId":"term_in_languages","summary":"What a term is called in other languages, from the language links of its English Wikipedia article — typically","description":"What a term is called in other languages, from the language links of its English Wikipedia article — typically\n    100–300 languages for common concepts, each with the language name and native script. Best for nouns and concepts;\n    it is a title-level translation, not a dictionary. Use for \"how do you say butterfly in other languages\", \"what is\n    photosynthesis called in Hindi and Japanese\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A concept, thing or name that has a Wikipedia article.","examples":["butterfly","photosynthesis","Tuesday"],"title":"Term","type":"string"},"languages":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional language codes to keep, e.g. ['es','fr','hi','ja']. Default: all available.","examples":[["es","fr","de","hi"]],"title":"Languages"}},"required":["term"],"title":"term_in_languagesArguments","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/text_stats":{"post":{"operationId":"text_stats","summary":"Readability and word statistics for a passage: word/sentence/syllable counts, Flesch Reading Ease, Flesch–Kincaid","description":"Readability and word statistics for a passage: word/sentence/syllable counts, Flesch Reading Ease, Flesch–Kincaid\n    grade, Gunning Fog, ARI, Coleman–Liau with a plain-English verdict, reading and speaking time, lexical diversity, top\n    words and longest words. Computed locally; the text is not sent anywhere. Use for \"how readable is this\", \"what grade\n    level is this writing\", \"word count and reading time\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"text":{"description":"The passage to analyse (up to ~20,000 characters).","title":"Text","type":"string"}},"required":["text"],"title":"text_statsArguments","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/word_of_the_day":{"post":{"operationId":"word_of_the_day","summary":"A word of the day — the same word for everyone on a given date — from a curated list of 560 memorable words, with","description":"A word of the day — the same word for everyone on a given date — from a curated list of 560 memorable words, with\n    its definition, pronunciation and examples. Use for \"word of the day\", \"teach me a new word\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"day":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date (YYYY-MM-DD); default today (UTC).","examples":["2026-09-23"],"title":"Day"}},"title":"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}}}}