la-rebelion avatar

Petstore MCP Server

la-rebelion/hapimcp

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 petstore

Run 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/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 19 tools

Verified 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.

Parameters* required
updatePetBody*object
x-hapi-auth-statestring
addPetAdd 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.

Parameters* required
addPetBody*object
x-hapi-auth-statestring
findPetsByStatusFinds 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.

Parameters* required
status*string
one of available · pending · sold
x-hapi-auth-statestring
findPetsByTagsFinds 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.

Parameters* required
tags*array
x-hapi-auth-statestring
getPetByIdFind pet by ID. - Returns a single pet.2 params

Find pet by ID. - Returns a single pet.

Parameters* required
petId*integer
x-hapi-auth-statestring
updatePetWithFormUpdates 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.

Parameters* required
namestring
petId*integer
statusstring
x-hapi-auth-statestring
deletePetDeletes a pet. - Delete a pet.3 params

Deletes a pet. - Delete a pet.

Parameters* required
api_keystring
petId*integer
x-hapi-auth-statestring
uploadFileUploads an image. - Upload image of the pet.4 params

Uploads an image. - Upload image of the pet.

Parameters* required
additionalMetadatastring
petId*integer
uploadFileBodystring
x-hapi-auth-statestring
getInventoryReturns 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.

Parameters* required
x-hapi-auth-statestring
placeOrderPlace 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.

Parameters* required
placeOrderBodyobject
x-hapi-auth-statestring
getOrderByIdFind 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.

Parameters* required
orderId*integer
x-hapi-auth-statestring
deleteOrderDelete 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.

Parameters* required
orderId*integer
x-hapi-auth-statestring
createUserCreate 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.

Parameters* required
createUserBodyobject
x-hapi-auth-statestring
createUsersWithListInputCreates 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.

Parameters* required
createUsersWithListInputBodyarray
x-hapi-auth-statestring
loginUserLogs user into the system. - Log into the system.3 params

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

Parameters* required
passwordstring
usernamestring
x-hapi-auth-statestring
logoutUserLogs 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.

Parameters* required
x-hapi-auth-statestring
getUserByNameGet user by user name. - Get user detail based on username.2 params

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

Parameters* required
username*string
x-hapi-auth-statestring
updateUserUpdate 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.

Parameters* required
updateUserBodyobject
username*string
x-hapi-auth-statestring
deleteUserDelete 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.

Parameters* required
username*string
x-hapi-auth-statestring

Sponsors

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.

View the full README on GitHub

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

More from la-rebelion