{"openapi":"3.1.0","info":{"title":"Telugu Names API","version":"0.1.0","description":"A fully local, hand-curated reference of real Telugu given names in native script: 50 verified names, each with romanized transliteration, gender, plain-language meaning and linguistic origin (Sanskrit-origin or Dravidian-vernacular, never religion or caste framing), plus search, gender/origin browsing, 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://telugunames.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/telugunames/docs"},"termsOfService":"https://connectorbay.com/telugunames/terms"},"servers":[{"url":"https://telugunames.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/telugunames/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: Telugu spelling, transliteration, gender, plain-language meaning, and","description":"One name's full detail: Telugu spelling, transliteration, gender, plain-language meaning, and\n    linguistic origin. Use for \"what does the name Lakshmi mean\", \"tell me about the Telugu name Arjun\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name's Telugu spelling, transliteration, or close English spelling.","examples":["Lakshmi","లక్ష్మి","Arjun"],"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 Telugu spelling, transliteration, meaning, note and origin. Use for","description":"Keyword search across every name's Telugu spelling, transliteration, meaning, note and origin. Use for\n    \"Telugu names meaning light\", \"find a Telugu name related to victory\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword, meaning, or theme to search for.","examples":["light","victory","moon","peace"],"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 of one gender. Use for \"list Telugu girl names\", \"give me Telugu boy names\".","description":"Every name of one gender. Use for \"list Telugu girl names\", \"give me Telugu boy names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gender":{"description":"'female' or 'male'.","examples":["female","male"],"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 to see valid values. Use for \"list","description":"Every name under one linguistic-origin category. Use list_origins to see valid values. Use for \"list\n    Telugu names of Dravidian-vernacular origin\", \"which names here are Sanskrit-origin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"origin":{"description":"An 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 name picked deterministically for a given date (today by default), optionally restricted to one","description":"One name picked deterministically for a given date (today by default), optionally restricted to one\n    gender. Use for \"give me a Telugu name of the day\", \"name idea for a girl today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"for_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date (YYYY-MM-DD); omit for today.","title":"For Date"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optionally restrict to 'female' or 'male'.","title":"Gender"}},"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 sharing the same gender, linguistic origin, and overlapping meaning with a given name. Use","description":"Other names sharing the same gender, linguistic origin, and overlapping meaning with a given name. Use\n    for \"names similar to Lakshmi\", \"other names like Arjun\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name's Telugu spelling, transliteration, or close English spelling.","minLength":1,"title":"Name","type":"string"},"limit":{"default":5,"description":"Maximum results.","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 suffixes and prefixes that recur across Telugu names — -అమ్మ, -అయ్య, -రావు, కుమార్/కుమారి,","description":"Definitions of suffixes and prefixes that recur across Telugu names — -అమ్మ, -అయ్య, -రావు, కుమార్/కుమారి,\n    శ్రీ, -నాథ్, -వర్మ — plus what \"Sanskrit-origin\" and \"Dravidian-vernacular\" mean here. Use for \"what does\n    the -amma suffix mean\", \"what's the difference between Sanskrit-origin and Dravidian-vernacular\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific suffix/prefix or 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 are filed under each. Use","description":"Every linguistic-origin category this reference uses, with how many names are filed under each. Use\n    for \"what origin categories do you use for Telugu names\".","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}}}}