# LotsStore API

> LotsStore: take your business online with a store that looks established and pays you directly into your own Stripe or Razorpay account, plus UPI and WhatsApp orders. 0% of your sales. These tools let an AI assistant manage products, stock, orders, discounts and payments for a store you own or manage. Every capability is defined once and served two ways: as a Model Context Protocol tool for AI agents, and as a REST endpoint. The two never drift, because they are generated from the same registry.

- Base URL: https://api.lotsstore.app
- Authentication: API key, sent as `Authorization: Bearer <key>` or `X-API-Key: <key>`
- MCP endpoint: https://api.lotsstore.app/mcp

## Documentation

- [REST API reference](https://api.lotsstore.app/docs): every endpoint, its parameters and its scopes, generated from the live registry.
- [MCP server guide](https://api.lotsstore.app/docs/mcp): connecting Claude, ChatGPT, Cursor and any other MCP client.
- [OpenAPI 3.0 spec](https://api.lotsstore.app/api/v1/docs?app=lotsstore&format=openapi): the machine-readable contract.
- [Endpoint list as JSON](https://api.lotsstore.app/api/v1/docs?app=lotsstore): method, path, description and category for each endpoint.

## Notes

- The endpoint list is generated, so it is current by construction. Read it rather than any summary of it.
- Publishing and other write actions follow the same validation and approval rules over the API and MCP as they do in the app.