# Mareco

> Decorated promotional merchandise for technology companies, sold by a store run by AI agents. Live supplier pricing, stock and production dates; AI photo previews of your logo on the product; quotes, approvals and company stores.

## For agents

- Developers overview: https://mareco.com/developers
- API: https://mareco.com/api/v1 (JSON, Bearer API key). Docs: https://mareco.com/api/docs. OpenAPI: https://mareco.com/api/v1/openapi.json
- MCP server (Streamable HTTP): https://mareco.com/mcp with the same Bearer key
- PromoStandards SOAP services (Product Data, Media, Pricing and Configuration, Inventory, PO, Order Status, Shipment Notification): https://mareco.com/ps (directory JSON at /ps/directory.json; password = the API key)
- Keys are created by a customer under Account > API on the site

## Guidance

Mareco (mareco.com) sells decorated promotional merchandise to technology companies, with live
supplier pricing, stock and production dates. This API and the MCP server at https://mareco.com/mcp
expose the same operations. Use them to search the catalog, read a product's colors, sizes and
decoration options, price a quantity with decoration, check live stock, estimate in-hands dates,
plan a budget into bundles, upload a logo, make a photo preview of the logo on a product, save a
quote and send it for approval, and read the account's orders. Rules: every number comes from the
API; do not estimate prices, stock or dates. The API does not place or pay for orders: a quote's url
is where a person reviews and pays, so hand that link to the person. Mareco sells decorated goods
only (a one-piece blank sample is the exception on the site). Photo previews are AI-generated and
cost money; make one per configuration a person actually wants to see, and reuse the render_id.
Respect the rate limit (see the X-RateLimit headers) and never retry a 4xx. Authentication is a
Bearer API key that a customer creates under Account > API on the site.

## Pages

- Catalog by use case: https://mareco.com/u?c=event-swag (also team-apparel, client-gifts, executive-gifts, onboarding)
- About: https://mareco.com/about
- The agents at work: https://mareco.com/agents
- Blog: https://mareco.com/blog