{"openapi":"3.1.0","info":{"title":"Kannada Names API","version":"0.1.0","description":"A hand-curated reference of Kannada given names, each in real Kannada script with a romanized transliteration, gender, plain-language meaning and linguistic origin, searchable by meaning, gender and origin.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://kannadanames.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/kannadanames/docs"},"termsOfService":"https://connectorbay.com/kannadanames/terms"},"servers":[{"url":"https://kannadanames.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/kannadanames/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/name_info":{"post":{"operationId":"name_info","summary":"One Kannada given name's full detail: Kannada script, transliteration, gender, plain-language meaning,","description":"One Kannada given name's full detail: Kannada script, transliteration, gender, plain-language meaning,\n    linguistic origin, and a short note. Use for \"what does the name Chaitanya mean\", \"tell me about the\n    Kannada name Kaveri\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name's Kannada script or romanized transliteration.","examples":["ಕಾವ್ಯ","Kavya","Chaitanya"],"minLength":1,"title":"Name","type":"string"}},"required":["name"],"title":"name_infoArguments","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/name_search":{"post":{"operationId":"name_search","summary":"Keyword search across every name's meaning, note, origin, transliteration and Kannada script -- matches","description":"Keyword search across every name's meaning, note, origin, transliteration and Kannada script -- matches\n    a theme word (e.g. \"lotus\", \"river\", \"joy\") as well as the name itself. Use for \"find Kannada names meaning\n    light\", \"names related to the moon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A meaning, theme, or name to search for.","examples":["lotus","joy","river","light"],"minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"name_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/names_by_gender":{"post":{"operationId":"names_by_gender","summary":"Every name usable for the given gender (boy/girl/unisex). Use for \"list Kannada girl names\", \"unisex","description":"Every name usable for the given gender (boy/girl/unisex). Use for \"list Kannada girl names\", \"unisex\n    Kannada names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gender":{"description":"boy | girl | unisex (or m/f/male/female).","examples":["girl","boy","unisex"],"minLength":1,"title":"Gender","type":"string"}},"required":["gender"],"title":"names_by_genderArguments","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/names_by_origin":{"post":{"operationId":"names_by_origin","summary":"Every name under one linguistic origin category. Use list_origins for valid names. Use for \"Kannada","description":"Every name under one linguistic origin category. Use list_origins for valid names. Use for \"Kannada\n    names of Dravidian origin\", \"list Sanskrit-origin Kannada names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"origin":{"description":"A linguistic origin category.","examples":["Sanskrit-origin","Dravidian-vernacular"],"minLength":1,"title":"Origin","type":"string"}},"required":["origin"],"title":"names_by_originArguments","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/name_of_the_day":{"post":{"operationId":"name_of_the_day","summary":"One Kannada given name picked deterministically for the given (or today's) date -- the same name for","description":"One Kannada given name picked deterministically for the given (or today's) date -- the same name for\n    everyone asking about that date. Use for \"Kannada name of the day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"on_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"An ISO date (YYYY-MM-DD). Omit to use today's date (UTC).","examples":["2026-09-25"],"title":"On Date"}},"title":"name_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}},"/v1/tools/similar_names":{"post":{"operationId":"similar_names","summary":"A few names related to the given one, ranked by shared meaning, then by matching origin and gender. Use","description":"A few names related to the given one, ranked by shared meaning, then by matching origin and gender. Use\n    for \"names similar to Kavya\", \"other names that also mean light\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name's Kannada script or transliteration.","minLength":1,"title":"Name","type":"string"},"limit":{"default":5,"description":"How many similar names to return.","maximum":10,"minimum":1,"title":"Limit","type":"integer"}},"required":["name"],"title":"similar_namesArguments","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/naming_glossary":{"post":{"operationId":"naming_glossary","summary":"Definitions of terms used throughout this reference -- tatsama, Dravidian-vernacular, unisex name,","description":"Definitions of terms used throughout this reference -- tatsama, Dravidian-vernacular, unisex name,\n    transliteration, epithet. Use for \"what does tatsama mean\".","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":"naming_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}},"/v1/tools/list_origins":{"post":{"operationId":"list_origins","summary":"Every linguistic origin category this reference uses, with how many names fall under each. Use for","description":"Every linguistic origin category this reference uses, with how many names fall under each. Use for\n    \"what origins of Kannada names do you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_originsArguments","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}}}}