# Aisles API and MCP

> How agents call Aisles: a read-only MCP server and JSON search API for store-level stock with check times. No sign-in or key. Part of https://aislesinventory.com/llms.txt.

## MCP server

- Endpoint: https://aislesinventory.com/mcp (Streamable HTTP, JSON-RPC 2.0, no sign-in)
- Tools: search_products, list_locations, list_answers
- Server card: https://aislesinventory.com/mcp/server-card
- Setup for Claude, ChatGPT and other clients: [https://aislesinventory.com/connect](https://aislesinventory.com/connect)

## Search API

- [Docs](https://aislesinventory.com/api/v1/docs): parameters, examples and responses
- [OpenAPI 3.1](https://aislesinventory.com/openapi.json)
- Example: https://aislesinventory.com/api/v1/search?q=oat%20milk&city=chicago&availability=available
- Errors are JSON: `{ "error": { "code": "...", "message": "..." } }`. Limit: 60 requests per minute (429 with Retry-After beyond it).

## Discovery files

- [ARD catalog](https://aislesinventory.com/.well-known/ard.json), [API catalog](https://aislesinventory.com/.well-known/api-catalog), [Agent skills](https://aislesinventory.com/.well-known/agent-skills/index.json)
- [Pricing](https://aislesinventory.com/pricing.md): free
- [Developers](https://aislesinventory.com/developers)