Swagger Petstore - OpenAPI 3.0

by Seabass SavageUpdated May 4, 2026

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.

openapi
swagger
api testing
|

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

  1. API Client Testing: Use findpetsbystatus and getpetbyid to query and retrieve pet data, validating client parsing of JSON responses.
  2. E-commerce Prototyping: Combine placeorder, getinventory, and addpet to simulate store inventory management and sales.
  3. Authentication Flows: Implement login with loginuser, then perform protected actions like updateuser or getuserbyname.
  4. 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.