Petstore MCP Server

Tags

registry.modelcontextprotocol.io

Configuration

{
  "mcpServers": {
    "petstore": {
      "url": "https://petstore.run.mcp.com.ai/mcp",
      "type": "http"
    }
  },
  "requiresAuth": false,
  "requiresOAuth": false
}

Available Tools (19)

updatePet

Update an existing pet. - Update an existing pet by Id.

Input Schema
{
  "type": "object",
  "required": [
    "updatePetBody"
  ],
  "properties": {
    "updatePetBody": {
      "type": "object",
      "required": [
        "name",
        "photoUrls"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "name": {
          "type": "string"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "format": "int64"
              },
              "name": {
                "type": "string"
              }
            }
          }
        },
        "status": {
          "enum": [
            "available",
            "pending",
            "sold"
          ],
          "type": "string",
          "description": "pet status in the store"
        },
        "category": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "format": "int64"
            },
            "name": {
              "type": "string"
            }
          }
        },
        "photoUrls": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

addPet

Add a new pet to the store. - Add a new pet to the store.

Input Schema
{
  "type": "object",
  "required": [
    "addPetBody"
  ],
  "properties": {
    "addPetBody": {
      "type": "object",
      "required": [
        "name",
        "photoUrls"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "name": {
          "type": "string"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "format": "int64"
              },
              "name": {
                "type": "string"
              }
            }
          }
        },
        "status": {
          "enum": [
            "available",
            "pending",
            "sold"
          ],
          "type": "string",
          "description": "pet status in the store"
        },
        "category": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "format": "int64"
            },
            "name": {
              "type": "string"
            }
          }
        },
        "photoUrls": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

findPetsByStatus

Finds Pets by status. - Multiple status values can be provided with comma separated strings.

Input Schema
{
  "type": "object",
  "required": [
    "status"
  ],
  "properties": {
    "status": {
      "enum": [
        "available",
        "pending",
        "sold"
      ],
      "type": "string"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

findPetsByTags

Finds Pets by tags. - Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.

Input Schema
{
  "type": "object",
  "required": [
    "tags"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

getPetById

Find pet by ID. - Returns a single pet.

Input Schema
{
  "type": "object",
  "required": [
    "petId"
  ],
  "properties": {
    "petId": {
      "type": "integer",
      "format": "int64"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

updatePetWithForm

Updates a pet in the store with form data. - Updates a pet resource based on the form data.

Input Schema
{
  "type": "object",
  "required": [
    "petId"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "petId": {
      "type": "integer",
      "format": "int64"
    },
    "status": {
      "type": "string"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

deletePet

Deletes a pet. - Delete a pet.

Input Schema
{
  "type": "object",
  "required": [
    "petId"
  ],
  "properties": {
    "petId": {
      "type": "integer",
      "format": "int64"
    },
    "api_key": {
      "type": "string"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

uploadFile

Uploads an image. - Upload image of the pet.

Input Schema
{
  "type": "object",
  "required": [
    "petId"
  ],
  "properties": {
    "petId": {
      "type": "integer",
      "format": "int64"
    },
    "uploadFileBody": {
      "type": "string",
      "format": "binary"
    },
    "x-hapi-auth-state": {
      "type": "string"
    },
    "additionalMetadata": {
      "type": "string"
    }
  }
}

getInventory

Returns pet inventories by status. - Returns a map of status codes to quantities.

Input Schema
{
  "type": "object",
  "properties": {
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

placeOrder

Place an order for a pet. - Place a new order in the store.

Input Schema
{
  "type": "object",
  "properties": {
    "placeOrderBody": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "petId": {
          "type": "integer",
          "format": "int64"
        },
        "status": {
          "enum": [
            "placed",
            "approved",
            "delivered"
          ],
          "type": "string",
          "description": "Order Status"
        },
        "complete": {
          "type": "boolean"
        },
        "quantity": {
          "type": "integer",
          "format": "int32"
        },
        "shipDate": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

getOrderById

Find purchase order by ID. - For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions.

Input Schema
{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "integer",
      "format": "int64"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

deleteOrder

Delete purchase order by identifier. - For valid response try integer IDs with value < 1000. Anything above 1000 or non-integers will generate API errors.

Input Schema
{
  "type": "object",
  "required": [
    "orderId"
  ],
  "properties": {
    "orderId": {
      "type": "integer",
      "format": "int64"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

createUser

Create user. - This can only be done by the logged in user.

Input Schema
{
  "type": "object",
  "properties": {
    "createUserBody": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "email": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "lastName": {
          "type": "string"
        },
        "password": {
          "type": "string"
        },
        "username": {
          "type": "string"
        },
        "firstName": {
          "type": "string"
        },
        "userStatus": {
          "type": "integer",
          "format": "int32",
          "description": "User Status"
        }
      }
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

createUsersWithListInput

Creates list of users with given input array. - Creates list of users with given input array.

Input Schema
{
  "type": "object",
  "properties": {
    "x-hapi-auth-state": {
      "type": "string"
    },
    "createUsersWithListInputBody": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "email": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "username": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "userStatus": {
            "type": "integer",
            "format": "int32",
            "description": "User Status"
          }
        }
      }
    }
  }
}

loginUser

Logs user into the system. - Log into the system.

Input Schema
{
  "type": "object",
  "properties": {
    "password": {
      "type": "string"
    },
    "username": {
      "type": "string"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

logoutUser

Logs out current logged in user session. - Log user out of the system.

Input Schema
{
  "type": "object",
  "properties": {
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

getUserByName

Get user by user name. - Get user detail based on username.

Input Schema
{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

updateUser

Update user resource. - This can only be done by the logged in user.

Input Schema
{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string"
    },
    "updateUserBody": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "format": "int64"
        },
        "email": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "lastName": {
          "type": "string"
        },
        "password": {
          "type": "string"
        },
        "username": {
          "type": "string"
        },
        "firstName": {
          "type": "string"
        },
        "userStatus": {
          "type": "integer",
          "format": "int32",
          "description": "User Status"
        }
      }
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}

deleteUser

Delete user resource. - This can only be done by the logged in user.

Input Schema
{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string"
    },
    "x-hapi-auth-state": {
      "type": "string"
    }
  }
}