TradeSDK Documentation

TradeSDK is an MCP (Model Context Protocol) server that gives AI agents access to real product data from Australian trade suppliers. Your agent calls our tools the same way it calls any MCP tool — search products, check stock, get pricing.

Quick Start

Get from zero to a working integration in under 5 minutes. Three steps.

{
  "mcpServers": {
    "tradesdk": {
      "url": "https://api.tradesdk.com/bunnings/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

POST https://api.tradesdk.com/bunnings/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "bunnings_search",
    "arguments": {
      "query": "90x45mm H3 pine"
    }
  }
}

Authentication

All requests require a Bearer token in the Authorization header. Your API key is generated when you sign up and is available in your dashboard.

Authorization: Bearer sk-mcp-xxxxxxxxxxxxxxxxxxxxxxxx

MCP Tools

TradeSDK exposes tools that your agent discovers automatically via the MCP protocol. Call tools/list to see all available tools at runtime.

{ "query": "poly pipe", "page": 1 }

{ "url_or_sku": "3120670" }

{ "query": "sleepers", "page": 1 }

{ "url_or_sku": "product-url-or-id" }

bunnings_search

Search Bunnings Warehouse products. Returns product name, SKU, brand, price, rating, image URL, and product URL. Use this to find products, compare prices, or check availability.

// Response shape
{
  "content": [
    {
      "type": "text",
      "text": "Found 24 results for \"poly pipe\"..."
    }
  ],
  "products": [
    {
      "name": "Holman 25mm x 50m Black Poly Pipe",
      "sku": "3120670",
      "brand": "Holman",
      "price": 89.98,
      "rating": 4.5,
      "image_url": "https://...",
      "product_url": "https://www.bunnings.com.au/..."
    }
  ]
}

bunnings_product

Get detailed product information from Bunnings Warehouse. Returns price, specifications, images, stock availability, ratings, aisle/bay location, and more.

// Example calls
{ "url_or_sku": "3120670" }
{ "url_or_sku": "https://www.bunnings.com.au/holman-25mm-x-50m-black-poly-pipe_p3120670" }

nuway_search

Search Nuway landscape supplies. Covers products available in South-East Queensland. Same interface as bunnings_search.

nuway_product

Get detailed product information from Nuway. Same interface as bunnings_product.

Integration Guides

Claude Desktop

Add TradeSDK to your Claude Desktop configuration file:

// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "tradesdk-bunnings": {
      "url": "https://api.tradesdk.com/bunnings/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "tradesdk-nuway": {
      "url": "https://api.tradesdk.com/nuway/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop after updating the config. Your agent will automatically discover the available tools and can call them during conversations.

ChatGPT

ChatGPT supports MCP servers via custom GPTs or the API. Point your MCP client at:

Endpoint: https://api.tradesdk.com/bunnings/mcp
Transport: HTTP + SSE (Server-Sent Events)
Auth:     Bearer token in Authorization header

Custom Agents (Python / Node.js)

Any MCP-compatible client can connect. The protocol is standard JSON-RPC 2.0:

# 1. Initialize the connection
POST /bunnings/mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {},
    "clientInfo": { "name": "my-agent", "version": "1.0.0" }
  }
}

# 2. List available tools
POST /bunnings/mcp
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list"
}

# 3. Call a tool
POST /bunnings/mcp
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "bunnings_search",
    "arguments": { "query": "poly pipe" }
  }
}

Rate Limits & Credits

Rate Limits

Error Codes

Credits & Billing

Credits are consumed per tool call. Search operations cost 1 credit; detailed product lookups cost 2 credits. Credits reset monthly on subscription plans, or can be topped up anytime with one-time credit packs.