Swagger Petstore - OpenAPI 3.0
Exposes a sample Pet Store API based on OpenAPI 3.0 specification with endpoints for pet management (addpet, updatepet, findpetsbystatus, findpetsbytags), inventory/orders (getinventory, placeorder), and user operations (createuser, loginuser). Developers use it to test API clients, validate OpenAPI implementations, and prototype store-like services.
Overview
This MCP server implements the Swagger Petstore sample API using OpenAPI 3.0. It simulates a pet store with operations for pets, inventory, orders, and users, serving as a reference for API design, client testing, and OpenAPI compliance.
Key Capabilities
- addpet: Adds a new pet to the store with details like name, status, and tags.
- updatepet: Updates an existing pet's information.
- findpetsbystatus: Retrieves pets filtered by status (e.g., available, pending, sold).
- findpetsbytags: Finds pets by specified tags.
- getpetbyid: Fetches a pet by its ID.
- updatepetwithform: Updates pet name and status via form data.
- uploadfile: Uploads a file with additional pet name and status.
- getinventory: Returns current pet inventory by status.
- placeorder: Places a new order for pets.
- getorderbyid: Retrieves an order by ID.
- createuser: Creates a new user account.
- createuserswithlistinput: Creates multiple users from a list.
- loginuser: Logs in a user and returns a token.
- logoutuser: Logs out the current user session.
- getuserbyname: Gets user details by username.
- updateuser: Updates user information.
Use Cases
- API Client Testing: Use findpetsbystatus and getpetbyid to query and retrieve pet data, validating client parsing of JSON responses.
- E-commerce Prototyping: Combine placeorder, getinventory, and addpet to simulate store inventory management and sales.
- Authentication Flows: Implement login with loginuser, then perform protected actions like updateuser or getuserbyname.
- File Handling Tests: Test multipart uploads via uploadfile for pet photos or documents.
Who This Is For
API developers learning OpenAPI 3.0, client implementers testing against a standard spec, and teams prototyping RESTful services for inventory or user management systems.