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.

perthss_search

Search for landscape supply products from Perth Sand & Soil (sand, soil, mulch, stone). Returns products with prices, images, and URLs.

perthss_product

Get detailed product information from Perth Sand & Soil. Returns price, description, SKU, stock status, and delivery info.

sydls_search

Search for landscape supply products from Sydney Landscape Supplies (mulches, soil, gravel, sand, pavers, timber). Returns products with prices per m³/item, images, and URLs.

sydls_product

Get detailed product information from Sydney Landscape Supplies. Returns price, description, images, and delivery info.

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

Apify Store (Serverless)

Don't want to manage a server? Our Bunnings scraper is available as a serverless Actor on Apify. Run it on-demand, pay per result, no subscription needed.

Option A: Via Apify MCP (mcp.apify.com)

Apify hosts an MCP server that exposes our Actor as tools. Add this to your MCP config:

{
  "mcpServers": {
    "bunnings-apify": {
      "url": "https://mcp.apify.com/?actor=lianm/bunnings-scraper-tradesdk"
    }
  }
}

Option B: Run the Actor directly

Call the Actor via Apify API from any language:

# Search for products
curl -X POST "https://api.apify.com/v2/acts/lianm~bunnings-scraper-tradesdk/runs" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "search",
    "query": "poly pipe",
    "max_results": 10
  }'

# Get product details
curl -X POST "https://api.apify.com/v2/acts/lianm~bunnings-scraper-tradesdk/runs" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "product",
    "sku_or_url": "3120670"
  }'

Results are stored in the Actor's dataset and can be downloaded as JSON, CSV, or Excel.

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 & Plans

Error Codes

Credits & Billing

Bunnings tools are completely free — no credits required, no limits beyond the rate cap. Credits are only consumed for premium supplier tools (Nuway, etc). 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 that never expire.