{"openapi":"3.1.0","info":{"title":"GroundTruth: 2026 US Tariff & Landed Cost API","version":"1.0.0","description":"Source-linked 2026 US import duty and landed cost facts for AI agents: layered tariffs (MFN, Section 301, Section 232, forced-labor), MPF, HMF and total landed cost, with official sources and an as-of date.","contact":{"url":"https://dytsk9wrfv.page.coze.site/groundtruth.html"}},"servers":[{"url":"https://winter-river-47fc.contentforge-press.workers.dev"}],"security":[{"apiKeyAuth":[]}],"tags":[{"name":"public"},{"name":"api"},{"name":"mcp"}],"paths":{"/health":{"get":{"tags":["public"],"summary":"Liveness, data date, KV status","security":[],"responses":{"200":{"description":"OK"}}}},"/v1/categories":{"get":{"tags":["public"],"summary":"List tariff categories, origin layers and fees (no key required)","security":[],"responses":{"200":{"description":"Categories and fees"}}}},"/try":{"get":{"tags":["public"],"summary":"Free no-signup, no-key tariff & landed-cost trial — callable directly by AI agents and workflows. Rate-limited per IP; attribution required.","security":[],"parameters":[{"name":"product_description","in":"query","required":true,"schema":{"type":"string"}},{"name":"origin_code","in":"query","required":true,"schema":{"type":"string","enum":["CN","VN","IN","MX","US"]}},{"name":"declared_value","in":"query","required":true,"schema":{"type":"number"}},{"name":"arrival_mode","in":"query","schema":{"type":"string","enum":["ocean","air"],"default":"ocean"}},{"name":"freight","in":"query","schema":{"type":"number"}},{"name":"insurance","in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":"Tariff and landed cost"},"429":{"description":"Too many requests"}}}},"/v1/account":{"get":{"tags":["api"],"summary":"Get plan, usage and expiry for an API key","parameters":[{"name":"key","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Account"},"404":{"description":"Unknown key"}}}},"/v1/tariff":{"get":{"tags":["api"],"summary":"Compute duty, MPF/HMF and landed cost","parameters":[{"name":"product_description","in":"query","required":true,"schema":{"type":"string"}},{"name":"origin_code","in":"query","required":true,"schema":{"type":"string","enum":["CN","VN","IN","MX","US"]}},{"name":"declared_value","in":"query","required":true,"schema":{"type":"number"}},{"name":"arrival_mode","in":"query","schema":{"type":"string","enum":["ocean","air"],"default":"ocean"}},{"name":"freight","in":"query","schema":{"type":"number"}},{"name":"insurance","in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":"Tariff and landed cost"},"401":{"description":"Invalid key"},"402":{"description":"Expired or over quota"}}}},"/mcp":{"post":{"tags":["mcp"],"summary":"MCP JSON-RPC endpoint (initialize, tools/list, tools/call)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC response"},"401":{"description":"Invalid key"}}}}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}}}}