Petstore MCP Server

{ "openapi": "3.1.0", "info": { "title": "User API v2", "version": "2.0.0", "description": "Extended user management API with list functionality" }, "servers": [ { "url": "https://api.example.com/v2" } ], "paths": { "/users": { "get": { "summary": "Get Users", "operationId": "getUsers", "description": "Get all users with optional pagination", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 10 }, "description": "Maximum number of users to return" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0 }, "description": "Number of users to skip" } ], "responses": { "200": { "description": "List of users", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserList" } } } } } }, "post": { "summary": "Create User", "operationId": "createUser", "description": "Create a new user", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateUserRequest" } } } }, "responses": { "201": { "description": "User created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/User" } } } }, "400": { "description": "Invalid request" } } } }, "/users/{userId}": { "get": { "summary": "Get User", "operationId": "getUser", "description": "Get a user by ID", "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "The user ID" } ], "responses": { "200": { "description": "User found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/User" } } } }, "404": { "description": "User not found" } } }, "delete": { "summary": "Delete User", "operationId": "deleteUser", "description": "Delete a user by ID", "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "The user ID" } ], "responses": { "204": { "description": "User deleted successfully" }, "404": { "description": "User not found" } } } } }, "components": { "schemas": { "User": { "type": "object", "properties": { "id": { "type": "string", "description": "Unique user identifier" }, "name": { "type": "string", "description": "User's full name" }, "email": { "type": "string", "format": "email", "description": "User's email address" }, "createdAt": { "type": "string", "format": "date-time", "description": "Account creation timestamp" } }, "required": ["id", "name", "email"] }, "CreateUserRequest": { "type": "object", "properties": { "name": { "type": "string", "description": "User's full name" }, "email": { "type": "string", "format": "email", "description": "User's email address" } }, "required": ["name", "email"] }, "UserList": { "type": "object", "properties": { "users": { "type": "array", "items": { "$ref": "#/components/schemas/User" } }, "total": { "type": "integer", "description": "Total number of users" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": ["users", "total"] } } } }