Gear Retailer Offers and Availability (Setup Gear Guide)

setupgearguide/get-offers

The current retailer offers for one Setup Gear Guide product by its id (for example sony-a7-iv or canon-eos-r5): per retailer, the retailer's home or search URL, the tracked link (some are affiliate links), whether the URL was verified, the estimated price in cents (null when not shown), availability, when it was last checked and how confident the estimate is. The response keeps the source's attribution object, which holds the affiliate disclosure that must be kept when republishing offers. An unknown id is refused as VALIDATION. Data from Setup Gear Guide, served by Eden Engine; not an official Setup Gear Guide product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Setup Gear Guide

Data from Setup Gear Guide (https://setupgearguide.com), a researched gear catalog with sourced specs and retailer offers. Some offer links are affiliate links. Served by Eden Engine; not an official Setup Gear Guide product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "setupgearguide/get-offers" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "setupgearguide/get-offers" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "setupgearguide/get-offers", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "setupgearguide/get-offers", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0026

Updated: Oct 25, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "productId"
  ],
  "properties": {
    "productId": {
      "type": "string",
      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
      "maxLength": 120,
      "description": "The product's id: the last part of its page address on setupgearguide.com, for example sony-a7-iv, canon-eos-r5, canon-r50, apogee-duet-3 or amd-rx-7600."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "productId",
    "offers",
    "attribution"
  ],
  "properties": {
    "offers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "retailer",
          "normalUrl",
          "affiliateUrl",
          "urlVerified",
          "finalUrl",
          "affiliate",
          "estimatedPriceCents",
          "availability",
          "priceLastChecked",
          "priceConfidence",
          "disclosureRequired"
        ],
        "properties": {
          "finalUrl": {
            "type": "string",
            "description": "Tracked link on setupgearguide.com that redirects to the retailer."
          },
          "retailer": {
            "type": "string",
            "description": "Retailer name."
          },
          "affiliate": {
            "type": "boolean",
            "description": "Whether the offer link is an affiliate link."
          },
          "normalUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Retailer home or search URL."
          },
          "urlVerified": {
            "type": "boolean"
          },
          "affiliateUrl": {
            "type": [
              "string",
              "null"
            ],
            "description": "Affiliate link; null when the offer carries none."
          },
          "availability": {
            "type": "string",
            "description": "Availability such as in_stock."
          },
          "priceConfidence": {
            "type": "string",
            "description": "Confidence in the estimate; null when none."
          },
          "priceLastChecked": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the estimate was last checked."
          },
          "disclosureRequired": {
            "type": "boolean",
            "description": "Whether the affiliate disclosure must accompany the offer."
          },
          "estimatedPriceCents": {
            "type": [
              "number",
              "null"
            ],
            "description": "Estimated price in US cents; null when not shown."
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per retailer."
    },
    "productId": {
      "type": "string",
      "description": "The product id."
    },
    "attribution": {
      "type": "object",
      "required": [
        "generatedBy",
        "affiliateDisclosure",
        "methodologyUrl",
        "canonicalUrl",
        "dataFreshness",
        "sourceConfidence"
      ],
      "properties": {
        "generatedBy": {
          "type": "string"
        },
        "canonicalUrl": {
          "type": "string"
        },
        "dataFreshness": {
          "type": "null"
        },
        "methodologyUrl": {
          "type": "string"
        },
        "sourceConfidence": {
          "type": "null"
        },
        "affiliateDisclosure": {
          "type": "string",
          "description": "Disclosure that some links may be affiliate links; keep it when republishing offer data."
        }
      },
      "description": "Credit and disclosure from the source: who generated the data, the affiliate disclosure to keep when republishing offers, the methodology and product page URLs, data freshness and source confidence.",
      "additionalProperties": true
    }
  },
  "description": "The `productId`, its `offers` and the source's `attribution` object.",
  "additionalProperties": true
}