{"schema_version":"1.0","service":"GF Agent Toll","version":"1.4.0","canonical_agent":"https://gfpick-agent-api.vercel.app","status":"accepting_orders","always_on":{"model":"stateless-http-plus-a2a-push","heartbeat":"https://gfpick-agent-api.vercel.app/robots/heartbeat","feed":"https://gfpick-agent-api.vercel.app/robots/feed","quote":"https://gfpick-agent-api.vercel.app/robots/quote","order":"https://gfpick-agent-api.vercel.app/robots/order","recommended_poll_seconds":60,"persistent_socket_required":false,"note":"Poll heartbeat/feed for continuous availability and use A2A push notifications for asynchronous task updates."},"protocols":{"http_json":{"active":true,"order":"https://gfpick-agent-api.vercel.app/robots/order"},"mcp":{"active":true,"url":"https://gfpick-agent-api.vercel.app/mcp"},"a2a":{"active":true,"agent_card":"https://gfpick-agent-api.vercel.app/.well-known/agent-card.json","push_notifications":true},"x402":{"active":true,"version":2,"network":"eip155:8453","asset":"USDC"}},"ordering":{"strategy":"free-first-then-lowest-cost-suitable-service","idempotency":"Send a stable Idempotency-Key and reuse it when retrying the same order.","payment_retry":"On HTTP 402, sign PAYMENT-REQUIRED and retry the same request with PAYMENT-SIGNATURE and the same Idempotency-Key.","retryable_statuses":[429,502,503],"discover_services":"https://gfpick-agent-api.vercel.app/robots/feed"},"services":[{"id":"free_profit_check","tool":"gf.free_profit_check","method":"POST","path":"/free/gcc-profit-check","price_usdc":0,"description":"Free preliminary GCC product profit and margin estimate.","tags":["gcc","profit","commerce"],"input_schema":{"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."}}},"example":{"currency":"SAR","landed_cost":55,"expected_sale_price":149,"total_fee_pct":20,"ad_cost_per_order":12,"fulfillment_cost":8},"robot_order":{"endpoint":"https://gfpick-agent-api.vercel.app/robots/order","service":"free_profit_check"}},{"id":"sa_landed_cost","tool":"gf.sa_landed_cost","method":"POST","path":"/v1/sa/landed-cost","price_usdc":0.25,"description":"Saudi import landed-cost calculation.","tags":["saudi","landed-cost","import"],"input_schema":{"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."}}},"example":{"currency":"SAR","product_value":100,"shipping":20,"insurance":0,"duty_rate_pct":5,"vat_rate_pct":15},"robot_order":{"endpoint":"https://gfpick-agent-api.vercel.app/robots/order","service":"sa_landed_cost"}},{"id":"gcc_opportunity_score","tool":"gf.gcc_opportunity_score","method":"POST","path":"/v1/gcc/opportunity-score","price_usdc":0.75,"description":"Unit economics, ROI and GCC opportunity score.","tags":["gcc","opportunity","roi"],"input_schema":{"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."}}},"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},"robot_order":{"endpoint":"https://gfpick-agent-api.vercel.app/robots/order","service":"gcc_opportunity_score"}},{"id":"gcc_product_decision","tool":"gf.gcc_product_decision","method":"POST","path":"/v1/gcc/product-decision","price_usdc":2.5,"description":"Premium end-to-end GCC product decision.","tags":["gcc","product","decision"],"input_schema":{"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."}}},"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},"robot_order":{"endpoint":"https://gfpick-agent-api.vercel.app/robots/order","service":"gcc_product_decision"}},{"id":"gcc_portfolio_rank","tool":"gf.gcc_portfolio_rank","method":"POST","path":"/v1/gcc/portfolio-rank","price_usdc":5,"description":"Rank 2-12 product scenarios by economics and risk.","tags":["gcc","portfolio","ranking"],"input_schema":{"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."}}}}}},"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}]},"robot_order":{"endpoint":"https://gfpick-agent-api.vercel.app/robots/order","service":"gcc_portfolio_rank"}},{"id":"gcc_merchant_pack","tool":"gf.gcc_merchant_pack","method":"POST","path":"/v1/gcc/merchant-pack","price_usdc":12,"description":"Merchant portfolio plan for 3-25 products.","tags":["gcc","merchant","portfolio"],"input_schema":{"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}}},"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},"robot_order":{"endpoint":"https://gfpick-agent-api.vercel.app/robots/order","service":"gcc_merchant_pack"}}]}