
Petstore MCP Server
A demo server that wraps the classic Swagger Petstore API (v1.0.27) using HAPI MCP's automatic OpenAPI-to-MCP conversion. You get instant access to the standard pet store operations,add pets, query inventory, place orders,without writing any MCP-specific code. Useful for testing MCP client integrations, prototyping agent workflows, or learning how HAPI transforms REST endpoints into callable tools. Runs on petstore.run.mcp.com.ai via streamable HTTP transport. If you're evaluating HAPI's approach to lifting existing APIs into the MCP ecosystem or need a sandbox for agent development, this gives you a working example with familiar CRUD operations.
- tools
- 19
- transport
- HTTP
- last updated
- Jan 7, 2026
Install
From registry metadata$ npx add-mcp https://petstore.run.mcp.com.ai/mcp --name petstoreRun in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http petstore https://petstore.run.mcp.com.ai/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 19 toolsVerified live against the running server on Nov 6, 2026.
updatePetUpdate an existing pet. - Update an existing pet by Id.2 params
Update an existing pet. - Update an existing pet by Id.
updatePetBody*objectx-hapi-auth-statestringaddPetAdd a new pet to the store. - Add a new pet to the store.2 params
Add a new pet to the store. - Add a new pet to the store.
addPetBody*objectx-hapi-auth-statestringfindPetsByStatusFinds Pets by status. - Multiple status values can be provided with comma separated strings.2 params
Finds Pets by status. - Multiple status values can be provided with comma separated strings.
status*stringavailable · pending · soldx-hapi-auth-statestringfindPetsByTagsFinds Pets by tags. - Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.2 params
Finds Pets by tags. - Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
tags*arrayx-hapi-auth-statestringgetPetByIdFind pet by ID. - Returns a single pet.2 params
Find pet by ID. - Returns a single pet.
petId*integerx-hapi-auth-statestringupdatePetWithFormUpdates a pet in the store with form data. - Updates a pet resource based on the form data.4 params
Updates a pet in the store with form data. - Updates a pet resource based on the form data.
namestringpetId*integerstatusstringx-hapi-auth-statestringdeletePetDeletes a pet. - Delete a pet.3 params
Deletes a pet. - Delete a pet.
api_keystringpetId*integerx-hapi-auth-statestringuploadFileUploads an image. - Upload image of the pet.4 params
Uploads an image. - Upload image of the pet.
additionalMetadatastringpetId*integeruploadFileBodystringx-hapi-auth-statestringgetInventoryReturns pet inventories by status. - Returns a map of status codes to quantities.1 params
Returns pet inventories by status. - Returns a map of status codes to quantities.
x-hapi-auth-statestringplaceOrderPlace an order for a pet. - Place a new order in the store.2 params
Place an order for a pet. - Place a new order in the store.
placeOrderBodyobjectx-hapi-auth-statestringgetOrderByIdFind purchase order by ID. - For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions.2 params
Find purchase order by ID. - For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions.
orderId*integerx-hapi-auth-statestringdeleteOrderDelete purchase order by identifier. - For valid response try integer IDs with value < 1000. Anything above 1000 or non-integers will generate API errors.2 params
Delete purchase order by identifier. - For valid response try integer IDs with value < 1000. Anything above 1000 or non-integers will generate API errors.
orderId*integerx-hapi-auth-statestringcreateUserCreate user. - This can only be done by the logged in user.2 params
Create user. - This can only be done by the logged in user.
createUserBodyobjectx-hapi-auth-statestringcreateUsersWithListInputCreates list of users with given input array. - Creates list of users with given input array.2 params
Creates list of users with given input array. - Creates list of users with given input array.
createUsersWithListInputBodyarrayx-hapi-auth-statestringloginUserLogs user into the system. - Log into the system.3 params
Logs user into the system. - Log into the system.
passwordstringusernamestringx-hapi-auth-statestringlogoutUserLogs out current logged in user session. - Log user out of the system.1 params
Logs out current logged in user session. - Log user out of the system.
x-hapi-auth-statestringgetUserByNameGet user by user name. - Get user detail based on username.2 params
Get user by user name. - Get user detail based on username.
username*stringx-hapi-auth-statestringupdateUserUpdate user resource. - This can only be done by the logged in user.3 params
Update user resource. - This can only be done by the logged in user.
updateUserBodyobjectusername*stringx-hapi-auth-statestringdeleteUserDelete user resource. - This can only be done by the logged in user.2 params
Delete user resource. - This can only be done by the logged in user.
username*stringx-hapi-auth-statestringSponsors
Readme
HAPI MCP – Headless API for Model Context Protocol
Stop rewriting systems for AI. Instantly turn your APIs into MCP servers.
HAPI MCP lifts your OpenAPI catalog into MCP tools automatically, keeping design (OAS/Arazzo) and runtime (agents/LLMs) cleanly separated. Your existing APIs become AI-ready tools—no new business logic, no sidecar servers, no rework.
Key Features
- No rewrites: Reuse 100% of your API logic. OpenAPI in, MCP tools out. No parallel codebase or shadow services.
- Faster time-to-value: Turn specs into agent-ready tools in minutes. Update the spec, ship new tools instantly.
- Reduced risk: Permissions, auth, rate limits, auditability are inherited from your APIs—governance without bolt-ons.
- Scales with you: runMCP delivers serverless-like elasticity with long-running when needed. Cold-start fast, stay warm for throughput.
- Deterministic orchestration: OrcA plans and executes multi-tool tasks predictably—no brittle prompt chaining.
- Vendor-neutral: Works with any MCP client: ChatGPT, Claude, QBot, chatMCP. OAS + MCP + Arazzo stay portable.
Details
- Repository
- github.com/la-rebelion/hapimcp
- Website
- run.mcp.com.ai
- Transport
- HTTP
- Registry
- MCP registry, active
- Resources
- 3
- Prompts
- 1
- Tools verified
- Nov 6, 2026