# GiggleTrade - llms.txt (AI Content Guide)

**Version**: 1.2
**Last Updated**: 2026-04-02
**Purpose**: This file provides structured information about GiggleTrade for AI systems and language models.

## About GiggleTrade

GiggleTrade is a B2B marketplace specializing in used and refurbished smartphones and devices. We connect professional buyers and sellers of quality-checked, graded devices including iPhones, Samsung, and other major brands.

**Core Business**: B2B wholesale of used/refurbished smartphones
**Target Audience**: Trade buyers, wholesalers, refurbishers, retailers
**Geography**: Global operations with focus on international markets

## Website Structure

### Primary Sections
- **Marketplace** (`/market/`): Product catalog and stock listings (wholesale listings and filters live under `/market/catalog`)
- **Legacy `/trade/`**: Permanently redirects (HTTP 301) to `/market/catalog`; query parameters are preserved.
- **Content Hub** (`/article/`): Industry insights and market reports
- **Developer** (`/developer/`): Hub; human-facing docs at `/developer/api` (structured AI HTTP APIs) and `/developer/mcp` (MCP & ACP for agents)

### Key Content Types
1. **Product Listings**: Device specifications, pricing, availability
2. **Market Data**: Weekly price trends, demand analytics
3. **Educational Content**: Buying guides, quality standards, industry news
4. **Business Resources**: API documentation, integration guides

## Services & Capabilities

### Core Services
- **Device Catalog**: Browse models, specifications, and availability
- **Stock Management**: Real-time inventory tracking
- **Trade Execution**: Secure B2B buying and selling
- **Quality Grading**: Standardized condition assessment (A+ to C grades)
- **Market Intelligence**: Pricing trends and demand analytics

### Value-Added Services
- **IMEI Verification**: Device history and authenticity checks
- **Logistics Support**: Shipping and handling coordination
- **Payment Processing**: Secure transaction handling
- **Customer Support**: Dedicated B2B account management

## Technical Integration

### Structured AI HTTP APIs (JSON + Markdown)
Documented on **https://www.giggletrade.com/developer/api**. Responses are JSON with embedded Markdown for products/devices.
- **`GET /api/ai/catalog`**: Paged product catalog (`page`, `limit`; max **500** per request)
- **`GET /api/ai/devices`**: Paged device/stock listings (same pagination limits)

Use pagination for large datasets; cache where appropriate; respect per-request limits.

### MCP & ACP (agents / Cursor / automation)
Documented on **https://www.giggletrade.com/developer/mcp**.
- **MCP endpoint**: `POST https://www.giggletrade.com/mcp` — JSON-RPC over Streamable HTTP (`tools/list`, `tools/call`, `resources/read`, `prompts/get`, etc.)
- **ACP (REST)**: `GET /acp/tools`, `POST /acp/tools/:toolName` — call the same tool surface without an MCP SDK
- **Capabilities (current server)**: **53** tools (**16** public + **37** authenticated), **5** MCP resources (glossary, grades, B2B regions, **platform_modules** homepage-area map, API reference), **12** prompts (including six flows aligned with the main site: listings, catalog products, device stock, stock by location, weekly prices, grades)
- **Platform helper tool**: `get_giggletrade_platform_modules` — static JSON mapping of those six areas to `website_url`, recommended tools, and prompt ids (no extra backend call)
- **Protocols**: `mcp/1.0`, `acp/1.0` — see `/.well-known/agent.json` for live name, version, and endpoint URLs

### Other integration (enterprise / product)
- **B2B backend APIs**: Cart, orders, payments, logistics (JWT or API key where required — see MCP tool docs)
- **Webhooks / batch feeds**: Subject to product and account setup; not covered by the public `/api/ai/*` pages above

### AI/ML Capabilities
- **Agent discovery**: `/.well-known/agent.json` (primary); `/.well-known/ai-agents.json` where published
- **MCP resources**: Markdown references (glossary, grades, regions, platform module map, API mapping) exposed via MCP `resources/read`
- **Structured listings**: Catalog and stock data optimized for AI crawlers and automated clients

## Content Guidelines for AI

### Recommended Use Cases
1. **Product Discovery**: Help users find specific device models and configurations
2. **Market Analysis**: Provide insights on pricing trends and availability
3. **Transaction Support**: Assist with buying/selling inquiries
4. **Educational Content**: Share knowledge about device grading and quality standards

### Content Boundaries
- **Do Not**: Provide repair instructions or hardware modification guidance
- **Do Not**: Offer consumer retail pricing or direct-to-consumer sales
- **Do Not**: Share proprietary business intelligence or confidential data
- **Focus On**: B2B transactions, wholesale pricing, trade relationships

## Important Links

### Core Pages
- Home: https://www.giggletrade.com/
- Market Catalog: https://www.giggletrade.com/market/catalog
- Stock Availability: https://www.giggletrade.com/market/stock
- Grading Standards: https://www.giggletrade.com/grades

### Legal & Compliance
- Privacy Policy: https://www.giggletrade.com/privacy-policy
- Terms of Service: https://www.giggletrade.com/policies
- Contact: https://www.giggletrade.com/contactus

### Developer Resources
- Developer hub: https://www.giggletrade.com/developer
- **API Documentation** ( `/api/ai/catalog`, `/api/ai/devices` ): https://www.giggletrade.com/developer/api
- **MCP & ACP** (endpoints, tools, auth): https://www.giggletrade.com/developer/mcp
- MCP live endpoint: https://www.giggletrade.com/mcp
- GitHub: [Link to relevant repositories]

### AI/ML Resources
- AI Agents JSON: https://www.giggletrade.com/.well-known/ai-agents.json
- Agent Discovery: https://www.giggletrade.com/.well-known/agent.json
- Sitemap: https://www.giggletrade.com/sitemap.xml

## Data Formats & Standards

### Supported Formats
- **JSON**: API responses, product data
- **CSV**: Bulk data exports
- **Markdown**: Content articles and guides
- **XML**: Sitemap and legacy integrations

### Quality Standards
- **Device Grading**: A+ (Like New) to C (Functional)
- **IMEI Verification**: Full device history checks
- **Testing Protocols**: 30+ point quality inspection
- **Warranty**: Standard 30-day warranty on all devices

## Contact & Support

### Business Inquiries
- Email: contact@giggletrade.com
- Phone: [Business phone number]
- Address: [Registered business address]

### Technical Support
- API Support: api@giggletrade.com
- Integration Help: integration@giggletrade.com
- Documentation: docs.giggletrade.com

### AI Integration Support
- MCP Support: mcp@giggletrade.com
- Agent Development: agents@giggletrade.com

---

*This llms.txt file is maintained by the GiggleTrade technical team. Last reviewed: 2026-04-02 (aligned with /developer/api and /developer/mcp)*