{"openapi":"3.0.3","info":{"title":"Gnist Context — Random Words","description":"Random English word generator — 120 curated words across 4 types (noun, verb, adjective, adverb) with length filtering.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/random-words/`\n- **Toolkit page:** `/toolkits/random-words`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/random-words/get_random_word":{"post":{"tags":["Reference"],"summary":"get_random_word","description":"Get a random English word.\n\nReturns a word with its type and length. Optionally filter by word type and length range.","operationId":"random_words_get_random_word","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"word_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by word type (noun, verb, adjective, adverb). Omit for any type."},"min_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Minimum word length (inclusive)."},"max_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum word length (inclusive)."}},"type":"object"}}}}}},"/rest/random-words/get_random_words":{"post":{"tags":["Reference"],"summary":"get_random_words","description":"Get multiple random English words at once.\n\nReturns a list of words, optionally filtered by type. Words are sampled without repeats.","operationId":"random_words_get_random_words","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Number of random words to return (default: 5, max: 50)."},"word_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by word type (noun, verb, adjective, adverb). Omit for any type."}},"type":"object"}}}}}},"/rest/random-words/search_words":{"post":{"tags":["Reference"],"summary":"search_words","description":"Search for words by substring.\n\nSearches across word text and word types. Case-insensitive.","operationId":"random_words_search_words","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search substring — matches word text or word type.","type":"string"},"max_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 20, max: 100)."}},"required":["query"],"type":"object"}}}}}},"/rest/random-words/list_word_types":{"post":{"tags":["Reference"],"summary":"list_word_types","description":"List all available word types.\n\nReturns the type names that can be used to filter random words (noun, verb, adjective, adverb).","operationId":"random_words_list_word_types","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/random-words/report_feedback":{"post":{"tags":["Reference"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"random_words_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Reference","description":"Data sources: Reference"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}