MCP & ACP API

Name

secondhand-mcp-server v2.0.0

Protocol

MCP 2024-11-05

Endpoint

https://giggletrade.com/mcp

Protocols: mcp/1.0 (JSON-RPC over Streamable HTTP), acp/1.0 (REST).

Base URL: use your deployment origin (e.g. https://giggletrade.com). MCP direct URL: https://giggletrade.com/mcp

Discover agent name, version, supported protocols, and endpoint URLs. No auth required.

Example response:

{
  "name": "secondhand-mcp-server",
  "version": "2.0.0",
  "description": "MCP agent for GiggleTrade secondhand device marketplace (catalog, stock, orders, auth, content).",
  "protocols": [
    "mcp/1.0",
    "acp/1.0"
  ],
  "capabilities": {
    "tools": 49,
    "resources": 4,
    "prompts": 6
  },
  "endpoints": {
    "mcp": "https://giggletrade.com/mcp",
    "acp": "https://giggletrade.com/acp",
    "health": "https://giggletrade.com/health"
  }
}

Call tools over standard HTTP. No MCP SDK required; use cURL, Postman, or any HTTP client.

GET /acp/tools — List tools

Returns {"tools": [{"name","description","inputSchema"}, ...]}. Cache-Control: public, max-age=300.

curl -s "https://giggletrade.com/acp/tools"

POST /acp/tools/:toolName — Invoke a tool

Body: JSON object with tool arguments. For auth-required tools, send Authorization: Bearer <JWT> or X-Api-Key: <API_KEY>. Response includes status, result, and metadata (tool, timestamp, request_id). Response header X-Request-ID is set for tracing.

curl -X POST "https://giggletrade.com/acp/tools/get_catalog_list" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer <JWT>" \\
  -d '{"page":1,"limit":10}'

Request body max 1 MB. Timeout 60 s; timeout errors return 504.

For MCP-native clients (e.g. Cursor, Claude Desktop, MCP Inspector). Streamable HTTP transport: send JSON-RPC requests (initialize, tools/list, tools/call, etc.). Use the connection URL below.

Only POST is accepted; use Content-Type: application/json and Accept: application/json, text/event-stream. Optional headers: X-Request-ID, X-Agent-ID.

Public tools (10) do not require auth. Authenticated tools (39) require JWT or API Key.

Product & Catalog (Public – No Auth)

• get_stock_list
• get_catalog_options
• get_catalog_models
• get_catalog_list
• get_product_detail
• get_product_stock
• get_stock_detail
• get_content_offers

Public Forms (No Auth)

Authenticated tools (by category)

High-impact tools (require user confirmation)

Clients should obtain user confirmation before calling these.

• convert_cart_to_order — Convert cart items to order
• cancel_order — Cancel an order
• ship_order — Update order logistics / ship
• pay_deposit — Pay order deposit (1/3)
• pay_balance — Pay order balance (2/3)

Resources (4)

Markdown content available via MCP resources/read.

• secondhand://glossary — Business glossary: Model, grade, stock, order, B2B concepts
• secondhand://grades — Device grade definitions: A+/A/B/C/A+++ with QC criteria
• secondhand://b2b_regions — Regional compliance guide: HK, FR, DE, UK, VAT, DDP/DDU
• secondhand://api — API reference documentation: MCP tools and API mapping

Prompts (6)

Pre-built workflows via MCP prompts/get.

• stock_overview — Domain intro + current stock view
• stock_by_model_grade — Filtered stock search
• b2b_assortment_advice — Business stocking recommendations
• regions_shipping_tax — Regional compliance explanation
• catalog_vs_stock — Compare listings vs actual inventory
• product_detail_similar — Product deep-dive with recommendations

This MCP server enables AI agents to:

• Browse inventory of used/refurbished phones (iPhone, Samsung, etc.)
• Check real-time stock with IMEI-level detail
• Manage B2B purchasing workflows (cart → order → payment → shipping)
• Handle multi-region logistics (Hong Kong hub, France/Germany/UK lines)
• Process payments with deposit/balance structure
• Track orders and communicate with sellers