Petstore Demo
This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters
Connect this API to an AI agent Browse all specs
What you can do with Petstore Demo via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| POST | /pet/{petId}/uploadImage |
uploadFile | uploads an image |
| POST | /pet |
addPet | Add a new pet to the store |
| PUT | /pet |
updatePet | Update an existing pet |
| GET | /pet/findByStatus |
findPetsByStatus | Finds Pets by status |
| GET | /pet/findByTags |
findPetsByTags | Finds Pets by tags |
| GET | /pet/{petId} |
getPetById | Find pet by ID |
| POST | /pet/{petId} |
updatePetWithForm | Updates a pet in the store with form data |
| DELETE | /pet/{petId} |
deletePet | Deletes a pet |
| GET | /store/inventory |
getInventory | Returns pet inventories by status |
| POST | /store/order |
placeOrder | Place an order for a pet |
| GET | /store/order/{orderId} |
getOrderById | Find purchase order by ID |
| DELETE | /store/order/{orderId} |
deleteOrder | Delete purchase order by ID |
| POST | /user/createWithList |
createUsersWithListInput | Creates list of users with given input array |
| GET | /user/{username} |
getUserByName | Get user by user name |
| PUT | /user/{username} |
updateUser | Updated user |
| DELETE | /user/{username} |
deleteUser | Delete user |
| GET | /user/login |
loginUser | Logs user into the system |
| GET | /user/logout |
logoutUser | Logs out current logged in user session |
| POST | /user/createWithArray |
createUsersWithArrayInput | Creates list of users with given input array |
| POST | /user |
createUser | Create user |
Authentication
api_key
API key — sent as the api_key header
petstore_auth
OAuth 2.0
Scopes: read:pets write:pets
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Petstore Demo” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.