{"openapi":"3.1.0","info":{"title":"Malayalam Names API","version":"0.1.0","description":"A hand-curated Malayalam given-name reference: real Malayalam script verified against a published source, romanized transliteration, gender, plain-language meaning, and linguistic origin (Sanskrit-origin, Dravidian-vernacular, Arabic-influenced, Hebrew/Greek-origin). Lookup, search by meaning, browsing by gender or origin, name of the day, similar-name suggestions, and a naming glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://malayalamnames.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/malayalamnames/docs"},"termsOfService":"https://connectorbay.com/malayalamnames/terms"},"servers":[{"url":"https://malayalamnames.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/malayalamnames/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 name's full detail: Malayalam script, transliteration, gender, plain-language meaning, linguistic","description":"One name's full detail: Malayalam script, transliteration, gender, plain-language meaning, linguistic\n    origin, and any notes. Use for \"what does the name Lakshmi mean\", \"tell me about the name Ameen\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name's transliteration or Malayalam script.","examples":["Arjun","Priya","Fathima","അർജുൻ"],"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, theme, origin and notes. Use for \"find Malayalam names","description":"Keyword search across every name's meaning, theme, origin and notes. Use for \"find Malayalam names\n    meaning moon\", \"names related to victory\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A meaning, theme, or keyword to search for.","examples":["light","moon","victory","wisdom"],"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 for one gender. Use for \"list female Malayalam names\", \"unisex Malayalam names\".","description":"Every name for one gender. Use for \"list female Malayalam names\", \"unisex Malayalam names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gender":{"description":"male | female | unisex (also accepts boy/girl).","examples":["male","female","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 sharing one linguistic origin. Use list_origins to see valid origin names. Use for \"list","description":"Every name sharing one linguistic origin. Use list_origins to see valid origin names. Use for \"list\n    Arabic-influenced Malayalam names\", \"show me Dravidian-vernacular names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"origin":{"description":"A linguistic origin — see list_origins.","examples":["Sanskrit-origin","Arabic-influenced","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":"A deterministic 'name of the day' — the same Malayalam name, with its full detail, for everyone who asks","description":"A deterministic 'name of the day' — the same Malayalam name, with its full detail, for everyone who asks\n    on a given date. Use for \"give me today's Malayalam name\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date (YYYY-MM-DD) to pick for; omit for today. Same date always gives the same name.","title":"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":"Other names that share a theme or gender (and often some meaning) with a given name. Use for \"suggest","description":"Other names that share a theme or gender (and often some meaning) with a given name. Use for \"suggest\n    names similar to Divya\", \"what other names go with Arjun\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name's transliteration or Malayalam script to find similar names for.","minLength":1,"title":"Name","type":"string"},"limit":{"default":5,"description":"Maximum number of 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 a few Malayalam naming-related terms: sthreenama, purushanama, the linguistic-origin","description":"Definitions of a few Malayalam naming-related terms: sthreenama, purushanama, the linguistic-origin\n    categories, and 'epithet'. Use for \"what does purushanama mean\", \"what is Dravidian-vernacular origin\".","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 used here, with how many names fall under each. Use for \"what","description":"Every linguistic origin category used here, with how many names fall under each. Use for \"what\n    linguistic origins of Malayalam 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}}}}