# Tradly

> Tradly is a headless, API-first commerce platform for building marketplaces, booking apps, delivery platforms, and multi-vendor storefronts. It provides auth, listings, payments, escrow, email, orders, CMS, and a web editor out of the box — so AI agents and developers focus on the product, not the infrastructure.

## What Tradly is

Tradly is a production-ready backend for commerce applications. It exposes a REST API at https://api.tradly.app and a SuperAdmin panel at https://superadmin.tradly.app. Developers and AI coding agents use Tradly to build:

- Multi-vendor marketplaces (C2C, B2C, B2B)
- Booking and appointment platforms
- Grocery and food delivery apps
- Service marketplaces
- Rental platforms
- Online stores and storefronts
- Freelance marketplaces
- Subscription commerce

## For AI Coding Agents

### Tradly Skills (for building)

Tradly Skills is a set of Claude Code skill files and field notes for building on the Tradly API. It encodes real production knowledge — auth flows, correct API endpoints, known gotchas, tenant config, Cloudflare setup — so agents don't discover them through trial and error.

- GitHub: https://github.com/TRADLY-PLATFORM/Tradly-Skills
- Primary skill: `skills/tradly-api/SKILL.md`
- Key topics: auth flow, correct endpoint paths, response shapes, search parameters, checkout sequence

### Tradly MCP (for operating)

The Tradly MCP server connects Claude, ChatGPT, Codex, and any MCP-compatible host to a live Tradly marketplace. Agents can query products, manage listings, search users, send emails, and run operations in natural language.

- npm: `npm install -g @tradly/mcp`
- MCP manifest: https://mcp.tradly.app/.well-known/mcp/manifest.json
- HTTP endpoint: https://mcp.tradly.app/api/mcp
- Docs: https://tradly.app/mcp

## Key API Facts (for agents)

- Base URL: `https://api.tradly.app`
- Auth header: `Authorization: Bearer <pk_live_key>` + `X-TRADLY-AGENT: 3`
- User sessions: `x-auth-key: <user_token>` (alongside the app key)
- Search parameter: `search_key` (not `q` — `q` is silently ignored)
- Listings path: `/products/v1/listings` (not `/listings`)
- All responses are wrapped under `data`: `payload?.data?.listings`

## Pages

- Homepage: https://tradly.app
- MCP docs: https://tradly.app/mcp
- Build with AI agents: https://tradly.app/agents
- Features: https://tradly.app/building-blocks
- Pricing: https://tradly.app/pricing
- API reference: https://developer.tradly.app
- SuperAdmin: https://superadmin.tradly.app

## Getting Started

1. Sign up at https://tradly.app
2. Get your API key from SuperAdmin → Settings → API: https://superadmin.tradly.app/api
3. For building: clone Tradly Skills into your project
4. For operating: `npm install -g @tradly/mcp` and set `TRADLY_API_KEY`