{"openapi":"3.1.0","info":{"title":"GF Agent Toll Agent API","version":"1.4.0","description":"Agent-native GCC commerce analysis with HTTP, MCP, A2A and x402. Canonical autonomous-agent entrypoint: https://gfpick-agent-api.vercel.app.","contact":{"name":"GF Pick","url":"https://www.gfpick.com"}},"externalDocs":{"description":"Developer Hub","url":"https://gfpick-agent-api.vercel.app/developers"},"servers":[{"url":"https://gfpick-agent-api.vercel.app"},{"url":"https://api.gfpick.com"}],"paths":{"/free/gcc-profit-check":{"post":{"operationId":"free_profit_check","tags":["gcc","profit","commerce"],"summary":"Free GCC profit check — FREE","description":"Free preliminary GCC product profit and margin estimate.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Referral-Code","in":"header","required":false,"schema":{"type":"string","maxLength":64}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}},{"name":"X-Request-ID","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeProfitInput"},"example":{"currency":"SAR","landed_cost":55,"expected_sale_price":149,"total_fee_pct":20,"ad_cost_per_order":12,"fulfillment_cost":8}}}},"responses":{"200":{"description":"Successful structured result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResult"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited"},"502":{"description":"Core unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Circuit open","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-x402-price-usdc":0,"x-x402-network":"eip155:8453","x-bazaar-input":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"currency":"SAR","landed_cost":55,"expected_sale_price":149,"total_fee_pct":20,"ad_cost_per_order":12,"fulfillment_cost":8}},"serviceName":"GF Agent Toll — Free GCC profit check","tags":["gcc","profit","commerce"]},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"const":"http"},"method":{"const":"POST"},"bodyType":{"const":"json"},"body":{"type":"object","additionalProperties":false,"required":["landed_cost","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"landed_cost":{"type":"number","description":"Landed cost per unit.","minimum":0.01,"maximum":1000000000000},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"total_fee_pct":{"type":"number","description":"Combined fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost per order."}}}},"required":["type","method","bodyType","body"]}},"required":["input"]}},"x-agent-retry-safe":true,"x-agent-canonical-origin":"https://gfpick-agent-api.vercel.app"}},"/v1/sa/landed-cost":{"post":{"operationId":"sa_landed_cost","tags":["saudi","landed-cost","import"],"summary":"Saudi Landed Cost — 0.25 USDC","description":"Saudi import landed-cost calculation.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Referral-Code","in":"header","required":false,"schema":{"type":"string","maxLength":64}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}},{"name":"X-Request-ID","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LandedCostInput"},"example":{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15}}}},"responses":{"200":{"description":"Successful structured result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResult"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"x402 v2 payment required. Read PAYMENT-REQUIRED, sign with the caller wallet, then retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64/JSON x402 v2 payment challenge.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402PaymentRequired"}}}},"429":{"description":"Rate limited"},"502":{"description":"Core unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Circuit open","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-x402-price-usdc":0.25,"x-x402-network":"eip155:8453","x-bazaar-input":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15}},"serviceName":"GF Agent Toll — Saudi Landed Cost","tags":["saudi","landed-cost","import"]},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"const":"http"},"method":{"const":"POST"},"bodyType":{"const":"json"},"body":{"type":"object","additionalProperties":false,"required":["product_value"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"product_value":{"type":"number","description":"Product purchase value.","minimum":0.01,"maximum":1000000000000},"shipping":{"type":"number","description":"Shipping cost."},"insurance":{"type":"number","description":"Insurance cost."},"duty_rate_pct":{"type":"number","description":"Customs duty percentage."},"vat_rate_pct":{"type":"number","description":"VAT percentage."}}}},"required":["type","method","bodyType","body"]}},"required":["input"]}},"x-agent-retry-safe":true,"x-agent-canonical-origin":"https://gfpick-agent-api.vercel.app"}},"/v1/gcc/opportunity-score":{"post":{"operationId":"gcc_opportunity_score","tags":["gcc","opportunity","roi"],"summary":"GCC Opportunity Score — 0.75 USDC","description":"Unit economics, ROI and GCC opportunity score.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Referral-Code","in":"header","required":false,"schema":{"type":"string","maxLength":64}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}},{"name":"X-Request-ID","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpportunityInput"},"example":{"currency":"SAR","landed_cost":55,"expected_sale_price":149,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":12,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3}}}},"responses":{"200":{"description":"Successful structured result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResult"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"x402 v2 payment required. Read PAYMENT-REQUIRED, sign with the caller wallet, then retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64/JSON x402 v2 payment challenge.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402PaymentRequired"}}}},"429":{"description":"Rate limited"},"502":{"description":"Core unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Circuit open","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-x402-price-usdc":0.75,"x-x402-network":"eip155:8453","x-bazaar-input":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"currency":"SAR","landed_cost":55,"expected_sale_price":149,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":12,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3}},"serviceName":"GF Agent Toll — GCC Opportunity Score","tags":["gcc","opportunity","roi"]},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"const":"http"},"method":{"const":"POST"},"bodyType":{"const":"json"},"body":{"type":"object","additionalProperties":false,"required":["landed_cost","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"landed_cost":{"type":"number","description":"Landed cost.","minimum":0.01,"maximum":1000000000000},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"marketplace_fee_pct":{"type":"number","description":"Marketplace fee percentage."},"payment_fee_pct":{"type":"number","description":"Payment fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost."},"returns_reserve_pct":{"type":"number","description":"Returns reserve percentage."},"other_cost_per_order":{"type":"number","description":"Other cost per order."},"competitor_count":{"type":"number","description":"Competitor count."},"delivery_days":{"type":"number","description":"Delivery days."}}}},"required":["type","method","bodyType","body"]}},"required":["input"]}},"x-agent-retry-safe":true,"x-agent-canonical-origin":"https://gfpick-agent-api.vercel.app"}},"/v1/gcc/product-decision":{"post":{"operationId":"gcc_product_decision","tags":["gcc","product","decision"],"summary":"GCC Product Decision — 2.50 USDC","description":"Premium end-to-end GCC product decision.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Referral-Code","in":"header","required":false,"schema":{"type":"string","maxLength":64}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}},{"name":"X-Request-ID","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDecisionInput"},"example":{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":199,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3}}}},"responses":{"200":{"description":"Successful structured result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResult"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"x402 v2 payment required. Read PAYMENT-REQUIRED, sign with the caller wallet, then retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64/JSON x402 v2 payment challenge.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402PaymentRequired"}}}},"429":{"description":"Rate limited"},"502":{"description":"Core unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Circuit open","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-x402-price-usdc":2.5,"x-x402-network":"eip155:8453","x-bazaar-input":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":199,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3}},"serviceName":"GF Agent Toll — GCC Product Decision","tags":["gcc","product","decision"]},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"const":"http"},"method":{"const":"POST"},"bodyType":{"const":"json"},"body":{"type":"object","additionalProperties":false,"required":["product_value","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"product_value":{"type":"number","description":"Product purchase value.","minimum":0.01,"maximum":1000000000000},"shipping":{"type":"number","description":"Shipping cost."},"insurance":{"type":"number","description":"Insurance cost."},"duty_rate_pct":{"type":"number","description":"Customs duty percentage."},"vat_rate_pct":{"type":"number","description":"VAT percentage."},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"marketplace_fee_pct":{"type":"number","description":"Marketplace fee percentage."},"payment_fee_pct":{"type":"number","description":"Payment processing fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost per order."},"returns_reserve_pct":{"type":"number","description":"Returns reserve percentage."},"other_cost_per_order":{"type":"number","description":"Other per-order cost."},"competitor_count":{"type":"number","description":"Competitor count."},"delivery_days":{"type":"number","description":"Delivery days."}}}},"required":["type","method","bodyType","body"]}},"required":["input"]}},"x-agent-retry-safe":true,"x-agent-canonical-origin":"https://gfpick-agent-api.vercel.app"}},"/v1/gcc/portfolio-rank":{"post":{"operationId":"gcc_portfolio_rank","tags":["gcc","portfolio","ranking"],"summary":"GCC Portfolio Rank — 5.00 USDC","description":"Rank 2-12 product scenarios by economics and risk.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Referral-Code","in":"header","required":false,"schema":{"type":"string","maxLength":64}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}},{"name":"X-Request-ID","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioRankInput"},"example":{"products":[{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":199,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3},{"currency":"SAR","product_value":80,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":169,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3}]}}}},"responses":{"200":{"description":"Successful structured result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResult"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"x402 v2 payment required. Read PAYMENT-REQUIRED, sign with the caller wallet, then retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64/JSON x402 v2 payment challenge.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402PaymentRequired"}}}},"429":{"description":"Rate limited"},"502":{"description":"Core unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Circuit open","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-x402-price-usdc":5,"x-x402-network":"eip155:8453","x-bazaar-input":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"products":[{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":199,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3},{"currency":"SAR","product_value":80,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":169,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3}]}},"serviceName":"GF Agent Toll — GCC Portfolio Rank","tags":["gcc","portfolio","ranking"]},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"const":"http"},"method":{"const":"POST"},"bodyType":{"const":"json"},"body":{"type":"object","additionalProperties":false,"required":["products"],"properties":{"products":{"type":"array","minItems":2,"maxItems":12,"items":{"type":"object","additionalProperties":false,"required":["product_value","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"product_value":{"type":"number","description":"Product purchase value.","minimum":0.01,"maximum":1000000000000},"shipping":{"type":"number","description":"Shipping cost."},"insurance":{"type":"number","description":"Insurance cost."},"duty_rate_pct":{"type":"number","description":"Customs duty percentage."},"vat_rate_pct":{"type":"number","description":"VAT percentage."},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"marketplace_fee_pct":{"type":"number","description":"Marketplace fee percentage."},"payment_fee_pct":{"type":"number","description":"Payment processing fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost per order."},"returns_reserve_pct":{"type":"number","description":"Returns reserve percentage."},"other_cost_per_order":{"type":"number","description":"Other per-order cost."},"competitor_count":{"type":"number","description":"Competitor count."},"delivery_days":{"type":"number","description":"Delivery days."}}}}}}},"required":["type","method","bodyType","body"]}},"required":["input"]}},"x-agent-retry-safe":true,"x-agent-canonical-origin":"https://gfpick-agent-api.vercel.app"}},"/v1/gcc/merchant-pack":{"post":{"operationId":"gcc_merchant_pack","tags":["gcc","merchant","portfolio"],"summary":"GCC Merchant Pack — 12.00 USDC","description":"Merchant portfolio plan for 3-25 products.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Referral-Code","in":"header","required":false,"schema":{"type":"string","maxLength":64}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}},{"name":"X-Request-ID","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MerchantPackInput"},"example":{"products":[{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":199,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3},{"currency":"SAR","product_value":80,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":169,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3},{"currency":"SAR","product_value":65,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":139,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3}],"working_capital":10000}}}},"responses":{"200":{"description":"Successful structured result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResult"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"x402 v2 payment required. Read PAYMENT-REQUIRED, sign with the caller wallet, then retry.","headers":{"PAYMENT-REQUIRED":{"description":"Base64/JSON x402 v2 payment challenge.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402PaymentRequired"}}}},"429":{"description":"Rate limited"},"502":{"description":"Core unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Circuit open","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-x402-price-usdc":12,"x-x402-network":"eip155:8453","x-bazaar-input":{"info":{"input":{"type":"http","method":"POST","bodyType":"json","body":{"products":[{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":199,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3},{"currency":"SAR","product_value":80,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":169,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3},{"currency":"SAR","product_value":65,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15,"expected_sale_price":139,"marketplace_fee_pct":15,"payment_fee_pct":2.5,"ad_cost_per_order":15,"fulfillment_cost":8,"returns_reserve_pct":3,"other_cost_per_order":2,"competitor_count":8,"delivery_days":3}],"working_capital":10000}},"serviceName":"GF Agent Toll — GCC Merchant Pack","tags":["gcc","merchant","portfolio"]},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"const":"http"},"method":{"const":"POST"},"bodyType":{"const":"json"},"body":{"type":"object","additionalProperties":false,"required":["products","working_capital"],"properties":{"products":{"type":"array","minItems":3,"maxItems":25,"items":{"type":"object","additionalProperties":false,"required":["product_value","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"product_value":{"type":"number","description":"Product purchase value.","minimum":0.01,"maximum":1000000000000},"shipping":{"type":"number","description":"Shipping cost."},"insurance":{"type":"number","description":"Insurance cost."},"duty_rate_pct":{"type":"number","description":"Customs duty percentage."},"vat_rate_pct":{"type":"number","description":"VAT percentage."},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"marketplace_fee_pct":{"type":"number","description":"Marketplace fee percentage."},"payment_fee_pct":{"type":"number","description":"Payment processing fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost per order."},"returns_reserve_pct":{"type":"number","description":"Returns reserve percentage."},"other_cost_per_order":{"type":"number","description":"Other per-order cost."},"competitor_count":{"type":"number","description":"Competitor count."},"delivery_days":{"type":"number","description":"Delivery days."}}}},"working_capital":{"type":"number","description":"Working capital.","minimum":1,"maximum":1000000000000}}}},"required":["type","method","bodyType","body"]}},"required":["input"]}},"x-agent-retry-safe":true,"x-agent-canonical-origin":"https://gfpick-agent-api.vercel.app"}}},"components":{"schemas":{"FreeProfitInput":{"type":"object","additionalProperties":false,"required":["landed_cost","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"landed_cost":{"type":"number","description":"Landed cost per unit.","minimum":0.01,"maximum":1000000000000},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"total_fee_pct":{"type":"number","description":"Combined fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost per order."}}},"LandedCostInput":{"type":"object","additionalProperties":false,"required":["product_value"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"product_value":{"type":"number","description":"Product purchase value.","minimum":0.01,"maximum":1000000000000},"shipping":{"type":"number","description":"Shipping cost."},"insurance":{"type":"number","description":"Insurance cost."},"duty_rate_pct":{"type":"number","description":"Customs duty percentage."},"vat_rate_pct":{"type":"number","description":"VAT percentage."}}},"OpportunityInput":{"type":"object","additionalProperties":false,"required":["landed_cost","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"landed_cost":{"type":"number","description":"Landed cost.","minimum":0.01,"maximum":1000000000000},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"marketplace_fee_pct":{"type":"number","description":"Marketplace fee percentage."},"payment_fee_pct":{"type":"number","description":"Payment fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost."},"returns_reserve_pct":{"type":"number","description":"Returns reserve percentage."},"other_cost_per_order":{"type":"number","description":"Other cost per order."},"competitor_count":{"type":"number","description":"Competitor count."},"delivery_days":{"type":"number","description":"Delivery days."}}},"ProductDecisionInput":{"type":"object","additionalProperties":false,"required":["product_value","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"product_value":{"type":"number","description":"Product purchase value.","minimum":0.01,"maximum":1000000000000},"shipping":{"type":"number","description":"Shipping cost."},"insurance":{"type":"number","description":"Insurance cost."},"duty_rate_pct":{"type":"number","description":"Customs duty percentage."},"vat_rate_pct":{"type":"number","description":"VAT percentage."},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"marketplace_fee_pct":{"type":"number","description":"Marketplace fee percentage."},"payment_fee_pct":{"type":"number","description":"Payment processing fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost per order."},"returns_reserve_pct":{"type":"number","description":"Returns reserve percentage."},"other_cost_per_order":{"type":"number","description":"Other per-order cost."},"competitor_count":{"type":"number","description":"Competitor count."},"delivery_days":{"type":"number","description":"Delivery days."}}},"PortfolioRankInput":{"type":"object","additionalProperties":false,"required":["products"],"properties":{"products":{"type":"array","minItems":2,"maxItems":12,"items":{"type":"object","additionalProperties":false,"required":["product_value","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"product_value":{"type":"number","description":"Product purchase value.","minimum":0.01,"maximum":1000000000000},"shipping":{"type":"number","description":"Shipping cost."},"insurance":{"type":"number","description":"Insurance cost."},"duty_rate_pct":{"type":"number","description":"Customs duty percentage."},"vat_rate_pct":{"type":"number","description":"VAT percentage."},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"marketplace_fee_pct":{"type":"number","description":"Marketplace fee percentage."},"payment_fee_pct":{"type":"number","description":"Payment processing fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost per order."},"returns_reserve_pct":{"type":"number","description":"Returns reserve percentage."},"other_cost_per_order":{"type":"number","description":"Other per-order cost."},"competitor_count":{"type":"number","description":"Competitor count."},"delivery_days":{"type":"number","description":"Delivery days."}}}}}},"MerchantPackInput":{"type":"object","additionalProperties":false,"required":["products","working_capital"],"properties":{"products":{"type":"array","minItems":3,"maxItems":25,"items":{"type":"object","additionalProperties":false,"required":["product_value","expected_sale_price"],"properties":{"currency":{"type":"string","description":"Scenario currency."},"product_value":{"type":"number","description":"Product purchase value.","minimum":0.01,"maximum":1000000000000},"shipping":{"type":"number","description":"Shipping cost."},"insurance":{"type":"number","description":"Insurance cost."},"duty_rate_pct":{"type":"number","description":"Customs duty percentage."},"vat_rate_pct":{"type":"number","description":"VAT percentage."},"expected_sale_price":{"type":"number","description":"Expected sale price.","minimum":0.01,"maximum":1000000000000},"marketplace_fee_pct":{"type":"number","description":"Marketplace fee percentage."},"payment_fee_pct":{"type":"number","description":"Payment processing fee percentage."},"ad_cost_per_order":{"type":"number","description":"Advertising cost per order."},"fulfillment_cost":{"type":"number","description":"Fulfillment cost per order."},"returns_reserve_pct":{"type":"number","description":"Returns reserve percentage."},"other_cost_per_order":{"type":"number","description":"Other per-order cost."},"competitor_count":{"type":"number","description":"Competitor count."},"delivery_days":{"type":"number","description":"Delivery days."}}}},"working_capital":{"type":"number","description":"Working capital.","minimum":1,"maximum":1000000000000}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","retryable"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}},"AgentResult":{"type":"object","description":"Structured GF Agent Toll result. Fields vary by selected commerce analysis tool.","additionalProperties":true},"X402PaymentRequired":{"type":"object","description":"x402 v2 payment challenge. Sign an accepted authorization in the caller wallet and retry the same request with PAYMENT-SIGNATURE.","additionalProperties":true}}},"x-agent-discovery":{"canonicalAgent":"https://gfpick-agent-api.vercel.app","legacyCore":"https://api.gfpick.com","x402":"https://gfpick-agent-api.vercel.app/.well-known/x402","catalog":"https://gfpick-agent-api.vercel.app/.well-known/x402-catalog.json","bazaar":"https://gfpick-agent-api.vercel.app/.well-known/x402-bazaar.json","openapi":"https://gfpick-agent-api.vercel.app/openapi.json","mcp":"https://gfpick-agent-api.vercel.app/mcp","a2a":"https://gfpick-agent-api.vercel.app/.well-known/agent-card.json","identity":"https://gfpick-agent-api.vercel.app/identity","jwks":"https://gfpick-agent-api.vercel.app/.well-known/jwks.json","skill":"https://gfpick-agent-api.vercel.app/skill.md","llms":"https://gfpick-agent-api.vercel.app/llms.txt","developers":"https://gfpick-agent-api.vercel.app/developers","payments":"https://gfpick-agent-api.vercel.app/payment-capabilities.json","compatibility":"https://gfpick-agent-api.vercel.app/.well-known/compatibility.json"},"x-compatibility":{"service":"GF Agent Toll","version":"1.4.0","policy":{"robot_interoperability_is_top_priority":true,"native_protocol_first":true,"advertise_only_working_capabilities":true,"preserve_free_access":true,"preserve_existing_x402_base_usdc":true,"unsupported_payment_methods_are_never_added_to_x402_accepts":true,"incoming_customer_payments_need_operator_approval":false,"outgoing_external_payments_need_operator_approval":true},"robot_priority":{"service":"GF Agent Toll","version":"1.4.0","policy":{"mode":"native-protocol-first","priority":1,"equal_priority_for_verified_robot_classes":true,"never_user_agent_sniff_for_protocol_selection":true,"advertise_only_verified_capabilities":true,"canonical_before_legacy":true,"free_discovery_and_free_qualification_remain_available":true},"robot_classes":{"mcp_agents":{"priority":100,"active":true,"canonical":{"version":"2026-07-28","transport":"streamable-http","url":"https://gfpick-agent-api.vercel.app/mcp"},"local_fallback":{"transport":"stdio","command":"npm run mcp:stdio"}},"a2a_agents":{"priority":100,"active":true,"canonical_version":"1.0","discovery":"https://gfpick-agent-api.vercel.app/.well-known/agent-card.json","preferred_interfaces":[{"protocolBinding":"JSONRPC","protocolVersion":"1.0","url":"https://gfpick-agent-api.vercel.app/a2a/rpc"},{"protocolBinding":"HTTP+JSON","protocolVersion":"1.0","url":"https://gfpick-agent-api.vercel.app"}],"legacy_fallback":{"protocolVersion":"0.3","active":true}},"openapi_http_agents":{"priority":100,"active":true,"canonical":"https://gfpick-agent-api.vercel.app/openapi.json","aliases":["https://gfpick-agent-api.vercel.app/.well-known/openapi.json","https://gfpick-agent-api.vercel.app/swagger.json","https://gfpick-agent-api.vercel.app/api/openapi.json"]},"local_desktop_agents":{"priority":100,"active":true,"protocol":"MCP","transport":"stdio","command":"npm run mcp:stdio"},"llm_indexers_and_crawlers":{"priority":100,"active":true,"discovery":["https://gfpick-agent-api.vercel.app/llms.txt","https://gfpick-agent-api.vercel.app/agents.txt","https://gfpick-agent-api.vercel.app/robots.txt","https://gfpick-agent-api.vercel.app/sitemap.xml"]},"x402_payment_agents":{"priority":100,"active":true,"protocol":"x402","version":2,"discovery":"https://gfpick-agent-api.vercel.app/.well-known/x402","network":"eip155:8453","asset":"USDC"}},"selection_policy":{"mcp_client":"use MCP directly","a2a_client":"use A2A 1.0 directly; fall back to 0.3 only when required","generic_tool_client":"use OpenAPI/HTTP JSON","local_process_client":"use MCP stdio","crawler_or_llm_indexer":"use llms.txt + agents.txt + sitemap.xml","payment_capable_agent":"discover x402 after selecting the native application protocol"},"compatibility_aliases":{"robot_priority":"https://gfpick-agent-api.vercel.app/.well-known/robot-priority.json","robot_discovery":"https://gfpick-agent-api.vercel.app/robot-discovery.json","openapi_well_known":"https://gfpick-agent-api.vercel.app/.well-known/openapi.json","swagger":"https://gfpick-agent-api.vercel.app/swagger.json","openapi_api_path":"https://gfpick-agent-api.vercel.app/api/openapi.json","llms_well_known":"https://gfpick-agent-api.vercel.app/.well-known/llms.txt","agent_card_short":"https://gfpick-agent-api.vercel.app/agent-card.json","mcp_manifest_short":"https://gfpick-agent-api.vercel.app/mcp.json"},"quality_gates":{"mcp_official_v2_client_http":true,"mcp_official_v2_client_stdio":true,"a2a_official_must_tck_jsonrpc":true,"a2a_official_must_tck_http_json":true,"a2a_official_must_tck_grpc":true,"contract_tests":true,"live_smoke":true}},"robot_transports":{"http_openapi":{"active":true,"priority":100,"url":"https://gfpick-agent-api.vercel.app/openapi.json"},"mcp_streamable_http":{"active":true,"priority":100,"version":"2026-07-28","url":"https://gfpick-agent-api.vercel.app/mcp"},"mcp_stdio":{"active":true,"priority":100,"mode":"local-process","command":"npm run mcp:stdio","note":"For desktop/CLI agents that spawn MCP servers locally; the process proxies to the same GF Agent Toll core."},"a2a_jsonrpc":{"active":true,"priority":100,"canonicalVersion":"1.0","legacyVersions":["0.3"],"url":"https://gfpick-agent-api.vercel.app/a2a/rpc"},"a2a_http_json":{"active":true,"priority":100,"canonicalVersion":"1.0","legacyVersions":["0.3"],"acceptedMediaTypes":["application/a2a+json","application/json"],"url":"https://gfpick-agent-api.vercel.app"},"a2a_grpc":{"active":false,"implementation_ready":true,"url":null,"reason":"Implementation and TCK gate are present; current Vercel HTTP deployment cannot accept inbound gRPC.","activation_requires":["gRPC-capable public host","TLS","set A2A_GRPC_ACTIVE=1","set A2A_GRPC_URL","production A2A gRPC TCK"]}},"payments":{"direction_policy":{"inbound_customer":{"mode":"automatic-inbound","direction":"customer-to-gf","manualOperatorApprovalRequired":false,"automaticAcceptance":true,"payerAuthorizationRequired":true,"rails":{"x402_wallet":{"automaticSettlementAfterPayerSignature":true,"operatorApprovalRequired":false},"paypal":{"automaticCaptureAfterPayerApproval":true,"operatorApprovalRequired":false}},"note":"Customer payments to GF do not require operator approval. The customer still authorizes their own wallet or PayPal payment, after which settlement/capture is automatic on configured rails."},"outbound_external":{"mode":"human-only","direction":"gf-to-external","manualOperatorApprovalRequired":true,"autonomousPayment":false,"autonomousSigning":false,"autonomousSettlement":false,"note":"GF Agent Toll may discover external payment requirements, but only an authorized human operator may approve and execute a payment from GF to an external service."}},"customer_inbound":{"manual_operator_approval_required":false,"x402_wallet":{"active":true,"network":"eip155:8453","pay_to":"0x4B7098E3b882633d3205FDE3E7ac7Ea1D965D3C3","automatic_settlement_after_customer_signature":true,"operator_approval_required":false},"paypal":{"environment":"sandbox","order_creation_ready":false,"automatic_capture_after_customer_approval":false,"verified_crediting_ready":false,"live_customer_funding_active":false,"operator_approval_required":false}},"outbound_external":{"manual_operator_approval_required":true,"autonomous_payment":false,"autonomous_signing":false,"autonomous_settlement":false},"active":[{"id":"x402-base-usdc-exact","protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":{"symbol":"USDC","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"payTo":"0x4B7098E3b882633d3205FDE3E7ac7Ea1D965D3C3","settlement_core":"https://api.gfpick.com","direction":"customer-to-gf","operator_approval_required":false,"automatic_settlement_after_customer_signature":true}],"inactive_until_configured":[{"id":"x402-solana-usdc","protocol":"x402","version":2,"reason":"No operator-controlled Solana receiving wallet/facilitator is configured.","activation_requires":["operator Solana payTo wallet","supported Solana USDC mint/network","facilitator verify+settle support","integration and settlement tests"]},{"id":"enterprise-api-key-credits","reason":"No durable API-key issuer and prepaid credit ledger is connected.","activation_requires":["key issuer","hashed key storage","credit ledger","rate/usage accounting","revocation"]},{"id":"paypal-customer-funding","protocol":"paypal-orders-v2","direction":"customer-to-gf","operator_approval_required":false,"reason":"Live PayPal customer funding activates when PAYPAL_ENV=live and PayPal API credentials are configured.","activation_requires":["PAYPAL_ENV=live","PAYPAL_CLIENT_ID","PAYPAL_CLIENT_SECRET","PAYPAL_WEBHOOK_ID for verified crediting","DATABASE_URL for durable credit ledger"]}]},"authentication":{"public_discovery":true,"caller_wallet_keys_received_by_server":false,"a2a_identity":"ES256 signed Agent Card","enterprise_oauth":{"active":false,"target":"OAuth 2.x with current MCP authorization metadata/CIMD compatibility","activation_requires":["authorization server/issuer","client metadata policy","token validation","issuer binding"]}}},"x-autonomous-purchase-policy":{"strategy":"free-first, then lowest-cost paid tool that satisfies the task","ladder":[{"service":"free_profit_check","price_usdc":0,"role":"qualification","recommended":true},{"service":"sa_landed_cost","price_usdc":0.25,"role":"low-cost paid entry","recommended":true},{"service":"gcc_opportunity_score","price_usdc":0.75,"role":"low-cost paid decision","recommended":true},{"service":"gcc_product_decision","price_usdc":2.5,"role":"premium single-product decision"},{"service":"gcc_portfolio_rank","price_usdc":5,"role":"multi-product ranking"},{"service":"gcc_merchant_pack","price_usdc":12,"role":"merchant portfolio plan"}],"payment":{"protocol":"x402","version":2,"network":"eip155:8453","asset":"USDC","payTo":"0x4B7098E3b882633d3205FDE3E7ac7Ea1D965D3C3"},"note":"Never require a wallet for the free qualification call. Paid calls return HTTP 402 before payment."}}