# GF Agent Toll — Agent Integration Layer

Version: 1.4.0
Canonical agent: https://gfpick-agent-api.vercel.app
Legacy/core compute origin: https://api.gfpick.com

## Recommended autonomous flow
1. Discover tools at https://gfpick-agent-api.vercel.app/.well-known/x402-catalog.json or MCP https://gfpick-agent-api.vercel.app/mcp.
2. Call gf.free_profit_check first when the task can be qualified without payment.
3. Prefer gf.sa_landed_cost (0.25 USDC) or gf.gcc_opportunity_score (0.75 USDC) before premium tools when they satisfy the goal.
4. Paid HTTP/MCP calls return an x402 v2 challenge before funds are authorized. Sign in the caller wallet and retry the same operation with PAYMENT-SIGNATURE/paymentSignature.
5. Use Idempotency-Key on retried HTTP requests.

## Discovery
- 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/JWKS: https://gfpick-agent-api.vercel.app/identity / https://gfpick-agent-api.vercel.app/.well-known/jwks.json
- Compatibility: https://gfpick-agent-api.vercel.app/.well-known/compatibility.json
- Payment capabilities: https://gfpick-agent-api.vercel.app/payment-capabilities.json
- MCP stdio: npm run mcp:stdio

## Payment
Protocol: x402 v2 exact on Base (eip155:8453), canonical USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. Pay-to: 0x4B7098E3b882633d3205FDE3E7ac7Ea1D965D3C3. The server never receives or stores caller private keys.

## Tools
- gf.list_services: List GF Agent Toll services, prices, schemas and discovery endpoints.
- gf.free_profit_check: Free preliminary GCC product profit and margin estimate. Price: free.
- gf.sa_landed_cost: Saudi import landed-cost calculation. Price: 0.25 USDC via x402.
- gf.gcc_opportunity_score: Unit economics, ROI and GCC opportunity score. Price: 0.75 USDC via x402.
- gf.gcc_product_decision: Premium end-to-end GCC product decision. Price: 2.50 USDC via x402.
- gf.gcc_portfolio_rank: Rank 2-12 product scenarios by economics and risk. Price: 5.00 USDC via x402.
- gf.gcc_merchant_pack: Merchant portfolio plan for 3-25 products. Price: 12.00 USDC via x402.