{"openapi":"3.1.0","info":{"title":"Punjabi Names API","version":"0.1.0","description":"A fully local, hand-curated reference of Punjabi given names in Gurmukhi script, each verified against a real source: romanization, plain-language meaning, gender, and linguistic origin (Sanskrit-origin, Persian-origin, Arabic-origin, or vernacular Punjabi), spanning the multiple faith communities that use Punjabi. Name lookup, meaning search, gender/origin browsing, similar-names lookup, and a naming glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://punjabinames.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/punjabinames/docs"},"termsOfService":"https://connectorbay.com/punjabinames/terms"},"servers":[{"url":"https://punjabinames.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/punjabinames/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 Punjabi given name: Gurmukhi script, romanization, plain-language meaning, gender, and","description":"Full detail for one Punjabi given name: Gurmukhi script, romanization, plain-language meaning, gender, and\n    linguistic origin. Use for \"what does the name Harpreet mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A Punjabi given name, romanized.","examples":["Harpreet","Simran","Kirpal"],"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":"Search Punjabi given names by keyword, meaning, or theme. Use for \"Punjabi names meaning love\", \"names with","description":"Search Punjabi given names by keyword, meaning, or theme. Use for \"Punjabi names meaning love\", \"names with\n    light in the meaning\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword, meaning, or theme to search for.","examples":["love","light","victory","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 tagged with one gender (male/female results also include unisex names). Use for \"list female","description":"Every name tagged with one gender (male/female results also include unisex names). Use for \"list female\n    Punjabi names\", \"unisex Punjabi names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gender":{"description":"male, female, or unisex.","examples":["male","female","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 origin names. Use for \"Persian-origin","description":"Every name of one linguistic origin. Use list_origins to see valid origin names. Use for \"Persian-origin\n    Punjabi names\", \"Sanskrit-origin names\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"origin":{"description":"A linguistic origin.","examples":["Sanskrit-origin","Persian-origin","Arabic-origin","Vernacular Punjabi"],"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 Punjabi given name, deterministically chosen by today's date. Use for \"name of the day\".","description":"One Punjabi given name, deterministically chosen by today's date. Use for \"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":"Other names sharing a root morpheme (like preet, deep, jeet), the same linguistic origin, or overlapping","description":"Other names sharing a root morpheme (like preet, deep, jeet), the same linguistic origin, or overlapping\n    meaning. Use for \"names similar to Harpreet\", \"other names with preet in them\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A name to find related names for.","minLength":1,"title":"Name","type":"string"},"limit":{"default":4,"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 common Punjabi name-building elements and terms — har (God), gur (guru), preet (love), deep","description":"Definitions of common Punjabi name-building elements and terms — har (God), gur (guru), preet (love), deep\n    (lamp), jeet (victory), Singh, Kaur. Use for \"what does preet mean in a name\", \"what does Singh 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 with how many names are tagged under it. Use for \"what origins of Punjabi","description":"Every linguistic origin category with how many names are tagged under it. Use for \"what origins of Punjabi\n    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}}}}