# Medusa Commerce API

> Headless commerce backend powered by Medusa 2, with UCP and MCP protocol support for AI agent integration.

## Store API

The Store API lets you browse products, manage carts, and complete checkouts.

- [Products](https://backend-production-297c4.up.railway.app/store/products): Browse and search the product catalog
- [Collections](https://backend-production-297c4.up.railway.app/store/collections): Browse product collections
- [Carts](https://backend-production-297c4.up.railway.app/store/carts): Create and manage shopping carts
- [Regions](https://backend-production-297c4.up.railway.app/store/regions): Available shipping regions
- [Shipping Options](https://backend-production-297c4.up.railway.app/store/shipping-options): Delivery methods and rates

## AI Agent Protocols

This store supports two protocols for AI agent integration:

- [UCP Manifest](https://backend-production-297c4.up.railway.app/.well-known/ucp): Unified Commerce Protocol business profile and checkout session management
- [UCP Checkout Sessions](https://backend-production-297c4.up.railway.app/ucp/v1/checkout-sessions): Create and manage checkout sessions programmatically
- [MCP Endpoint](https://backend-production-297c4.up.railway.app/mcp): Model Context Protocol JSON-RPC 2.0 endpoint with tools for product search, cart management, and policy lookup

## MCP Tools

The MCP endpoint provides 5 tools for AI agents:

- search-catalog: Search the product catalog by keyword
- get-product-details: Get full details for a specific product
- get-cart: Retrieve the current state of a cart
- update-cart: Add, update, or remove line items in a cart
- search-policies: Look up shipping and refund policies

## Admin API

- [Admin Dashboard](https://backend-production-297c4.up.railway.app/app): Medusa Admin UI for store management