{"openapi":"3.1.0","info":{"title":"Tamil Names API","version":"0.1.0","description":"A fully local, hand-curated reference of real Tamil given names: Tamil script, romanization, gender, meaning and linguistic origin for each, searchable by keyword, gender or origin.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://tamilnames.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/tamilnames/docs"},"termsOfService":"https://connectorbay.com/tamilnames/terms"},"servers":[{"url":"https://tamilnames.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/tamilnames/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":"Full detail for one Tamil given name: Tamil script, romanization, gender, plain-language meaning,","description":"Full detail for one Tamil given name: Tamil script, romanization, gender, plain-language meaning,\n    linguistic origin, and any extra etymology note. Use for \"what does the name Vetri mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name's Tamil text, romanization, or id.","examples":["Priya","செல்வன்","kurinji"],"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, and romanization. Use for \"Tamil names that","description":"Keyword search across every name's meaning, theme, and romanization. Use for \"Tamil names that\n    mean flower\", \"names meaning victory\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search by meaning or theme.","examples":["flower","victory","moon"],"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 the given gender. Use for \"list Tamil girl names\", \"boy names in this collection\".","description":"Every name for the given gender. Use for \"list Tamil girl names\", \"boy names in this collection\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gender":{"description":"boy, girl, or unisex.","examples":["boy","girl","unisex"],"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 of one linguistic origin. Use list_origins to see valid origins. Use for \"list","description":"Every name of one linguistic origin. Use list_origins to see valid origins. Use for \"list\n    Tamil-vernacular names\", \"Sanskrit-origin names in this collection\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"origin":{"description":"A linguistic origin.","examples":["Sanskrit-origin","Tamil-vernacular"],"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 featured Tamil name, rotating daily. Use for \"give me a Tamil name of the day\".","description":"One featured Tamil name, rotating daily. Use for \"give me a Tamil name of the day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"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":"Finds names with a related theme, meaning or linguistic origin. Use for \"names similar to","description":"Finds names with a related theme, meaning or linguistic origin. Use for \"names similar to\n    Thamarai\", \"what else means something like Vetri\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name's Tamil text, romanization, or id to find similar names for.","minLength":1,"title":"Name","type":"string"},"count":{"default":5,"description":"How many similar names to return.","maximum":10,"minimum":1,"title":"Count","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 common Tamil naming terms — the -an/-i masculine/feminine suffixes, selvam","description":"Definitions of common Tamil naming terms — the -an/-i masculine/feminine suffixes, selvam\n    (wealth), arasu (kingdom), the Sangam thinai landscapes, and more. Use for \"what does the -an\n    ending mean in Tamil names\".","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 covered, with how many names are tagged with it. Use for \"what","description":"Every linguistic origin covered, with how many names are tagged with it. Use for \"what\n    linguistic origins of Tamil names do you have\".","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}}}}