{"openapi":"3.1.0","info":{"title":"Paws API","version":"0.1.0","description":"Dog and cat breed profiles and finder, breed photos, toxic-item checks, human-equivalent age, vaccination schedules, pet food lookup, facts.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://paws.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/paws/docs"},"termsOfService":"https://connectorbay.com/paws/terms"},"servers":[{"url":"https://paws.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/paws/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/breed":{"post":{"operationId":"breed","summary":"A breed profile: size, weight and height, lifespan, temperament, energy/grooming/shedding/trainability scores","description":"A breed profile: size, weight and height, lifespan, temperament, energy/grooming/shedding/trainability scores\n    (1–5), good-with-kids and apartment ratings, origin and the health problems to watch for. Use for \"tell me about\n    Beagles\", \"how big do Maine Coons get\", \"are Huskies good in apartments\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Breed name (dog or cat).","examples":["Labrador","Maine Coon","Indie","French Bulldog"],"title":"Name","type":"string"},"species":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"dog | cat (default both)","title":"Species"}},"required":["name"],"title":"breedArguments","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/breed_finder":{"post":{"operationId":"breed_finder","summary":"Suggest breeds for a lifestyle: filter by size, energy, grooming and shedding; rank for children, apartment","description":"Suggest breeds for a lifestyle: filter by size, energy, grooming and shedding; rank for children, apartment\n    living and trainability. Use for \"low-shedding small dog for an apartment\", \"calm cat for a family\", \"which\n    breed suits a runner\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"default":"dog","description":"dog | cat","title":"Species","type":"string"},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"small | medium | large | giant","title":"Size"},"energy_max":{"anyOf":[{"maximum":5,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Max energy level you can meet (1 couch – 5 athlete).","title":"Energy Max"},"grooming_max":{"anyOf":[{"maximum":5,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Max grooming effort (1–5).","title":"Grooming Max"},"shedding_max":{"anyOf":[{"maximum":5,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Max shedding (1–5).","title":"Shedding Max"},"kids":{"default":false,"description":"Prioritise good-with-children.","title":"Kids","type":"boolean"},"apartment":{"default":false,"description":"Prioritise apartment-friendly (dogs).","title":"Apartment","type":"boolean"},"trainable":{"default":false,"description":"Prioritise easy training (dogs).","title":"Trainable","type":"boolean"},"max_results":{"default":6,"maximum":15,"minimum":1,"title":"Max Results","type":"integer"}},"title":"breed_finderArguments","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/breed_photo":{"post":{"operationId":"breed_photo","summary":"Random photo(s) of a dog breed (dog.ceo) or cat breed (TheCatAPI). Use for \"show me a Husky\", \"what does a","description":"Random photo(s) of a dog breed (dog.ceo) or cat breed (TheCatAPI). Use for \"show me a Husky\", \"what does a\n    Bengal cat look like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Breed name.","examples":["Husky","Bengal","Pug"],"title":"Name","type":"string"},"count":{"default":1,"maximum":5,"minimum":1,"title":"Count","type":"integer"}},"required":["name"],"title":"breed_photoArguments","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/toxic_check":{"post":{"operationId":"toxic_check","summary":"Is it dangerous for a dog or cat? Severity (severe/high/moderate/low/safe), why, and which species — for 44","description":"Is it dangerous for a dog or cat? Severity (severe/high/moderate/low/safe), why, and which species — for 44\n    foods, plants, medicines and household items including safe treats. Use for \"can dogs eat grapes\", \"is lily\n    toxic to cats\", \"my dog ate ibuprofen\", \"safe fruits for dogs\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item":{"description":"Food, plant, medicine or household item.","examples":["grapes","lily","ibuprofen","peanut butter","onion"],"title":"Item","type":"string"},"species":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"dog | cat (default both)","title":"Species"}},"required":["item"],"title":"toxic_checkArguments","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/pet_age":{"post":{"operationId":"pet_age","summary":"Human-equivalent age and life stage for a dog (by size) or cat. Use for \"how old is my 7-year-old Lab in","description":"Human-equivalent age and life stage for a dog (by size) or cat. Use for \"how old is my 7-year-old Lab in\n    human years\", \"is my 12-year-old cat a senior\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"description":"dog | cat","title":"Species","type":"string"},"age_years":{"description":"Age in years (e.g. 0.5 for six months).","exclusiveMinimum":0,"maximum":35,"title":"Age Years","type":"number"},"size":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Dog size: small | medium | large | giant (affects ageing).","title":"Size"}},"required":["species","age_years"],"title":"pet_ageArguments","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/vaccine_schedule":{"post":{"operationId":"vaccine_schedule","summary":"Core and optional vaccinations by age for dogs or cats (DHPP/FVRCP, rabies, leptospirosis, FeLV…), with","description":"Core and optional vaccinations by age for dogs or cats (DHPP/FVRCP, rabies, leptospirosis, FeLV…), with\n    timing notes. Use for \"puppy vaccination schedule\", \"what shots does a kitten need\", \"when is the rabies booster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"description":"dog | cat","title":"Species","type":"string"},"age":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional: 'puppy', 'kitten', 'adult', or an age like '10 weeks'.","title":"Age"}},"required":["species"],"title":"vaccine_scheduleArguments","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/pet_food":{"post":{"operationId":"pet_food","summary":"Look up pet food on Open Pet Food Facts by name or barcode: brand, category, quantity, ingredients, labels","description":"Look up pet food on Open Pet Food Facts by name or barcode: brand, category, quantity, ingredients, labels\n    and nutrition per 100 g. Use for \"what's in Royal Canin kitten food\", \"scan this barcode\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Product or brand words.","examples":["Royal Canin kitten","Pedigree adult"],"title":"Query"},"barcode":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Product barcode (EAN/UPC).","title":"Barcode"},"max_results":{"default":6,"maximum":15,"minimum":1,"title":"Max Results","type":"integer"}},"title":"pet_foodArguments","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/pet_fact":{"post":{"operationId":"pet_fact","summary":"A random dog or cat fact. Use for \"tell me a cat fact\".","description":"A random dog or cat fact. Use for \"tell me a cat fact\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"default":"cat","description":"dog | cat","title":"Species","type":"string"}},"title":"pet_factArguments","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}}}}