SupplyGraph.AI

Generates comprehensive supplier due diligence reports using global enterprise data, benchmarking ownership, legal, and financial risk for compliance and procurement decisions. Pricing: {"unit": "credits", "options": [{"chapter_name": "Company Registration Information", "per_run": 1518}, {"chapter_name": "Branch Offices", "per_run": 1650}, {"chapter_name": "Corporate Brand Initiatives", "per_run": 2079}, {"chapter_name": "Administrative Sanctions", "per_run": 1485}, {"chapter_name": "Software Copyright Details", "per_run": 1551}, {"chapter_name": "Outbound Investments", "per_run": 1650}, {"chapter_name": "Financing Activities", "per_run": 1452}, {"chapter_name": "Competitor Analysis", "per_run": 1485}, {"chapter_name": "Subsidiary Companies", "per_run": 1848}, {"chapter_name": "Trademark Portfolio", "per_run": 4059}, {"chapter_name": "Patent Holdings", "per_run": 12045}, {"chapter_name": "Website Registrations", "per_run": 1419}, {"chapter_name": "Court Judgments", "per_run": 1584}, {"chapter_name": "Shareholder Structure", "per_run": 1386}, {"chapter_name": "Senior Management Team", "per_run": 1452}, {"chapter_name": "Administrative Permits", "per_run": 1749}, {"chapter_name": "Court Hearing Notices", "per_run": 3696}, {"chapter_name": "Court Notices", "per_run": 3597}, {"chapter_name": "Equity Pledges", "per_run": 1419}, {"chapter_name": "Mobile Applications", "per_run": 1386}, {"chapter_name": "Copyrighted Works", "per_run": 1749}, {"chapter_name": "Equity Freezes", "per_run": 1419}, {"chapter_name": "Chattel Mortgages", "per_run": 1419}, {"chapter_name": "WeChat Official Accounts", "per_run": 1386}, {"chapter_name": "Tendering and Bidding Activities", "per_run": 2145}, {"chapter_name": "Qualification Certificates", "per_run": 2310}, {"chapter_name": "Engineering Irregularities", "per_run": 1419}, {"chapter_name": "Major Regulatory Violations", "per_run": 1452}, {"chapter_name": "Compensation and Benefits", "per_run": 1386}, {"chapter_name": "Enforcement Targets", "per_run": 1452}, {"chapter_name": "Supplier Network", "per_run": 1584}, {"chapter_name": "Credit Ratings", "per_run": 1419}, {"chapter_name": "Tax Offenses", "per_run": 1419}, {"chapter_name": "Regulatory Spot Checks", "per_run": 1485}, {"chapter_name": "Import-Export Credit Records", "per_run": 1386}, {"chapter_name": "Regulatory Actions", "per_run": 1617}, {"chapter_name": "Granted Government Subsidies", "per_run": 1551}, {"chapter_name": "Eligible Government Subsidies", "per_run": 1584}, {"chapter_name": "Consolidated Statements of Operations", "per_run": 1749}, {"chapter_name": "Income Statement", "per_run": 1947}, {"chapter_name": "Statement of Cash Flows", "per_run": 2442}, {"chapter_name": "Consolidated Balance Sheets", "per_run": 2145}, {"chapter_name": "ALL", "per_run": 26400}]}

{
  "type": "object",
  "properties": {
    "pid": {
      "type": "string",
      "description": "Internal company ID for the target enterprise, obtained from the search_company_candidates MCP tool (e.g. a77828f060c866441f2403384b271e63 for Tesla, Inc.)."
    },
    "chapter_name": {
      "type": "string",
      "description": "Report chapter to generate. Omit or use ALL for the full due diligence report.",
      "enum": [
        "ALL",
        "Company Registration Information",
        "Branch Offices",
        "Corporate Brand Initiatives",
        "Administrative Sanctions",
        "Software Copyright Details",
        "Outbound Investments",
        "Financing Activities",
        "Competitor Analysis",
        "Subsidiary Companies",
        "Trademark Portfolio",
        "Patent Holdings",
        "Website Registrations",
        "Court Judgments",
        "Shareholder Structure",
        "Senior Management Team",
        "Administrative Permits",
        "Court Hearing Notices",
        "Court Notices",
        "Equity Pledges",
        "Mobile Applications",
        "Copyrighted Works",
        "Equity Freezes",
        "Chattel Mortgages",
        "WeChat Official Accounts",
        "Tendering and Bidding Activities",
        "Qualification Certificates",
        "Engineering Irregularities",
        "Major Regulatory Violations",
        "Compensation and Benefits",
        "Enforcement Targets",
        "Supplier Network",
        "Credit Ratings",
        "Tax Offenses",
        "Regulatory Spot Checks",
        "Import-Export Credit Records",
        "Regulatory Actions",
        "Granted Government Subsidies",
        "Eligible Government Subsidies",
        "Consolidated Statements of Operations",
        "Income Statement",
        "Statement of Cash Flows",
        "Consolidated Balance Sheets"
      ],
      "default": "ALL"
    }
  },
  "required": [
    "pid"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "results"
          ],
          "description": "Indicates structured due diligence report output."
        },
        "data": {
          "type": "object",
          "properties": {
            "languages": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Array of language codes indicating the languages included in the response, where 'zk' represents Chinese and 'en' represents English."
            },
            "report_infos": {
              "type": "object",
              "properties": {
                "en": {
                  "type": "object",
                  "properties": {
                    "report_date": {
                      "type": "string",
                      "description": "Report generation date in English."
                    },
                    "report_name": {
                      "type": "string",
                      "description": "Full report name in English."
                    },
                    "report_type": {
                      "type": "string",
                      "description": "Type of the report in English."
                    }
                  },
                  "required": [
                    "report_date",
                    "report_name",
                    "report_type"
                  ]
                },
                "zh": {
                  "type": "object",
                  "properties": {
                    "report_date": {
                      "type": "string",
                      "description": "Report generation date in Chinese."
                    },
                    "report_name": {
                      "type": "string",
                      "description": "Full report name in Chinese."
                    },
                    "report_type": {
                      "type": "string",
                      "description": "Type of the report in Chinese."
                    }
                  },
                  "required": [
                    "report_date",
                    "report_name",
                    "report_type"
                  ]
                }
              },
              "required": [
                "en"
              ],
              "description": "Dictionary containing report metadata in English and Chinese."
            },
            "chapter_infos": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "en": {
                    "type": "object",
                    "properties": {
                      "chapter_name": {
                        "type": "string",
                        "description": "Chapter name in English."
                      },
                      "sub_sections": {
                        "type": "array",
                        "items": {
                          "$ref": "#/definitions/sub_section"
                        },
                        "description": "Array of sub-sections in English."
                      },
                      "chapter_texts": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Array of chapter text paragraphs in English, formatted in Markdown for structured presentation including headings, lists, tables, and links to provide comprehensive and professional due diligence content."
                      }
                    },
                    "required": [
                      "chapter_name",
                      "sub_sections",
                      "chapter_texts"
                    ]
                  },
                  "zh": {
                    "type": "object",
                    "properties": {
                      "chapter_name": {
                        "type": "string",
                        "description": "Chapter name in Chinese."
                      },
                      "sub_sections": {
                        "type": "array",
                        "items": {
                          "$ref": "#/definitions/sub_section"
                        },
                        "description": "Array of sub-sections in Chinese."
                      },
                      "chapter_texts": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Array of chapter text paragraphs in Chinese, formatted in Markdown for structured presentation including headings, lists, tables, and links to provide comprehensive and professional due diligence content."
                      }
                    },
                    "required": [
                      "chapter_name",
                      "sub_sections",
                      "chapter_texts"
                    ]
                  }
                },
                "required": [
                  "en"
                ]
              },
              "description": "Array of chapter information in the due diligence report."
            }
          },
          "required": [
            "languages",
            "report_infos",
            "chapter_infos"
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured due diligence report output for enterprise analysis."
    }
  ],
  "definitions": {
    "sub_section": {
      "type": "object",
      "properties": {
        "section_title": {
          "type": "string",
          "description": "Sub-section title."
        },
        "sub_sections": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/sub_section"
          },
          "description": "Nested array of sub-sections."
        },
        "section_texts": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Array of sub-section text paragraphs, formatted in Markdown for detailed and structured content including headings, bullet points, tables, and hyperlinks to ensure professional and informative due diligence subsections."
        }
      },
      "required": [
        "section_title",
        "sub_sections",
        "section_texts"
      ]
    }
  }
}

Calculates U.S. customs duties by combining HTS base rates with applicable Chapter 99 measures, providing transparent, rule-based tariff outcomes. Pricing: {"unit": "credits", "per_run": 10}

{
  "type": "object",
  "properties": {
    "product_description": {
      "type": "string",
      "description": "Description of the product to import into the United States, e.g. HS code, product name, material, or specifications."
    },
    "country_or_region": {
      "type": "string",
      "description": "Country or region of origin for the imported product, e.g. China, Mexico, European Union."
    }
  },
  "required": [
    "product_description",
    "country_or_region"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "result"
          ],
          "description": "Indicates that the response contains structured tariff and duty calculation results."
        },
        "data": {
          "type": "object",
          "properties": {
            "calculation_result": {
              "type": "string",
              "description": "Detailed tariff and duty calculation outcome, including duty rates and estimated costs across different trade routes or scenarios."
            }
          },
          "required": [
            "calculation_result"
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured output representing the results of tariff and duty calculations for different trade routes or import scenarios."
    }
  ],
  "description": "Primary agent output. Agents return text/Markdown for intermediate, failed, or user-dependent states, and structured JSON only when the task completes successfully."
}

Enterprise Change Report Pricing: {"unit": "credits", "options": [{"chapter_name": "License", "per_run": 1518}, {"chapter_name": "GovRel", "per_run": 1419}, {"chapter_name": "R&D", "per_run": 1749}, {"chapter_name": "Reputation", "per_run": 8481}, {"chapter_name": "Ops", "per_run": 1749}, {"chapter_name": "GeneralRisks", "per_run": 1617}, {"chapter_name": "Profile", "per_run": 1749}, {"chapter_name": "Cost", "per_run": 1386}, {"chapter_name": "Compliance", "per_run": 1419}, {"chapter_name": "Competition", "per_run": 1452}, {"chapter_name": "Brand", "per_run": 3168}, {"chapter_name": "HR", "per_run": 1419}, {"chapter_name": "ALL", "per_run": 26400}]}

{
  "type": "object",
  "properties": {
    "pid": {
      "type": "string",
      "description": "Internal company ID for the target enterprise, obtained from the search_company_candidates MCP tool (e.g. a77828f060c866441f2403384b271e63 for Tesla, Inc.)."
    },
    "chapter_name": {
      "type": "string",
      "description": "Exception domain chapter to generate. Omit or use ALL for the full corporate exception report.",
      "enum": [
        "ALL",
        "Profile",
        "License",
        "GovRel",
        "R&D",
        "Reputation",
        "Ops",
        "GeneralRisks",
        "Cost",
        "Compliance",
        "Competition",
        "Brand",
        "HR"
      ],
      "default": "ALL"
    }
  },
  "required": [
    "pid"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "results"
          ],
          "description": "Indicates structured corporate exception report output."
        },
        "data": {
          "type": "object",
          "properties": {
            "languages": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Array of language codes indicating the languages included in the response, where 'zk' represents Chinese and 'en' represents English."
            },
            "report_infos": {
              "type": "object",
              "properties": {
                "en": {
                  "type": "object",
                  "properties": {
                    "report_date": {
                      "type": "string",
                      "description": "Report generation date in English."
                    },
                    "report_name": {
                      "type": "string",
                      "description": "Full report name in English."
                    },
                    "report_type": {
                      "type": "string",
                      "description": "Type of the report in English."
                    }
                  },
                  "required": [
                    "report_date",
                    "report_name",
                    "report_type"
                  ]
                },
                "zh": {
                  "type": "object",
                  "properties": {
                    "report_date": {
                      "type": "string",
                      "description": "Report generation date in Chinese."
                    },
                    "report_name": {
                      "type": "string",
                      "description": "Full report name in Chinese."
                    },
                    "report_type": {
                      "type": "string",
                      "description": "Type of the report in Chinese."
                    }
                  },
                  "required": [
                    "report_date",
                    "report_name",
                    "report_type"
                  ]
                }
              },
              "required": [
                "en"
              ],
              "description": "Dictionary containing report metadata in English and Chinese."
            },
            "chapter_infos": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "en": {
                    "type": "object",
                    "properties": {
                      "chapter_name": {
                        "type": "string",
                        "description": "Chapter name in English."
                      },
                      "sub_sections": {
                        "type": "array",
                        "items": {
                          "$ref": "#/definitions/sub_section"
                        },
                        "description": "Array of sub-sections in English."
                      },
                      "chapter_texts": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Array of chapter text paragraphs in English, formatted in Markdown for structured presentation including headings, lists, tables, and links to provide comprehensive and professional corporate exception content."
                      }
                    },
                    "required": [
                      "chapter_name",
                      "sub_sections",
                      "chapter_texts"
                    ]
                  },
                  "zh": {
                    "type": "object",
                    "properties": {
                      "chapter_name": {
                        "type": "string",
                        "description": "Chapter name in Chinese."
                      },
                      "sub_sections": {
                        "type": "array",
                        "items": {
                          "$ref": "#/definitions/sub_section"
                        },
                        "description": "Array of sub-sections in Chinese."
                      },
                      "chapter_texts": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Array of chapter text paragraphs in Chinese, formatted in Markdown for structured presentation including headings, lists, tables, and links to provide comprehensive and professional corporate exception content."
                      }
                    },
                    "required": [
                      "chapter_name",
                      "sub_sections",
                      "chapter_texts"
                    ]
                  }
                },
                "required": [
                  "en"
                ]
              },
              "description": "Array of chapter information in the corporate exception report."
            }
          },
          "required": [
            "languages",
            "report_infos",
            "chapter_infos"
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured corporate exception report output for enterprise analysis."
    }
  ],
  "definitions": {
    "sub_section": {
      "type": "object",
      "properties": {
        "section_title": {
          "type": "string",
          "description": "Sub-section title."
        },
        "sub_sections": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/sub_section"
          },
          "description": "Nested array of sub-sections."
        },
        "section_texts": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Array of sub-section text paragraphs, formatted in Markdown for detailed and structured content including headings, bullet points, tables, and hyperlinks to ensure professional and informative corporate exception subsections."
        }
      },
      "required": [
        "section_title",
        "sub_sections",
        "section_texts"
      ]
    }
  }
}

Search company candidates by company name, optionally filtered by country or region, and return possible matching records with mapped company IDs for caller-side selection. Pricing: {"unit": "credits", "billing_model": "per_run", "per_run": 1}

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Company name with optional country or region. The input should contain a company name, and may optionally include its country or region (e.g. 'Tesla United States', 'Samsung South Korea', 'Huawei China')."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "company_candidate_search"
          ],
          "description": "Indicates structured company candidate search results with mapped company IDs."
        },
        "data": {
          "type": "object",
          "properties": {
            "candidates": {
              "type": "array",
              "description": "List of matched company candidates with internal company IDs.",
              "items": {
                "type": "object",
                "properties": {
                  "pid": {
                    "type": "string",
                    "description": "Internal company ID used by downstream agents or MCP tools."
                  },
                  "company_name": {
                    "type": "string",
                    "description": "Matched company name."
                  },
                  "country_name": {
                    "type": "string",
                    "description": "Country or region of the company. May be empty if unknown or not provided."
                  }
                },
                "required": [
                  "pid",
                  "company_name"
                ]
              }
            }
          },
          "required": [
            "candidates"
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured output for resolving company names into candidate company IDs."
    }
  ],
  "description": "Primary agent output. Returns structured candidate company IDs for downstream agent/MCP tool resolution, or text output for intermediate/error states."
}

Analyzes multi-tier supply chains to detect single-country concentration and quantify geographic dependency across regions. Pricing: {"unit": "credits", "per_run": 264590}

{
  "type": "object",
  "properties": {
    "pid": {
      "type": "string",
      "description": "Internal company ID for the target enterprise, obtained from the search_company_candidates MCP tool (e.g. a77828f060c866441f2403384b271e63 for Tesla, Inc.)."
    },
    "region_name": {
      "type": "string",
      "description": "Standardized country or region name for geographic concentration analysis, obtained from the search_region_candidates MCP tool (e.g. China, United States, Hong Kong)."
    }
  },
  "required": [
    "pid",
    "region_name"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "sg_chokepoint_results"
          ],
          "description": "Indicates that the response contains structured report data"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "content_type": {
                "type": "string",
                "enum": [
                  "dir",
                  "paragraph"
                ],
                "description": "\"dir\" indicates a title or heading element; \"paragraph\" indicates a body text element."
              },
              "content": {
                "type": "string",
                "description": "The actual text content of the element. For titles it may include markdown heading syntax; for paragraphs it contains narrative text."
              }
            },
            "required": [
              "content_type",
              "content"
            ]
          },
          "examples": [
            [
              {
                "content_type": "dir",
                "content": "Summary"
              },
              {
                "content_type": "paragraph",
                "content": "### Research Objective\nThis report applies the Herfindahl–Hirschman Index (HHI) methodology to evaluate the geographic concentration and risk exposure of Tesla, Inc.’s global supply chain."
              }
            ]
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured output representing the report data of Geographic Concentration Analysis  "
    }
  ],
  "description": "Primary agent output. Agents return text/Markdown for intermediate, failed, or user-dependent states, and structured JSON only when the task completes successfully."
}

Generates global multi-tier supply-chain graphs providing full visibility into enterprise and product dependencies. Pricing: {"unit": "credits", "per_run": 264590}

{
  "type": "object",
  "properties": {
    "pid": {
      "type": "string",
      "description": "Internal company ID for the target enterprise, obtained from the search_company_candidates MCP tool (e.g. a77828f060c866441f2403384b271e63 for Tesla, Inc.)."
    }
  },
  "required": [
    "pid"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "sg_visualization_results"
          ],
          "description": "Indicates that the response contains structured supply chain graph data."
        },
        "data": {
          "type": "object",
          "properties": {
            "pid": {
              "type": "string",
              "description": "Unique ID of the company-centered supply chain graph."
            },
            "company_name": {
              "type": "string",
              "description": "Name of the company for which the graph is generated."
            },
            "max_depth": {
              "type": "integer",
              "description": "Maximum dependency depth of the graph (i.e., the longest path in the dependency hierarchy)."
            },
            "dependencies": {
              "type": "array",
              "description": "List of edges in the dependency graph, each representing a dependency from one node to another.",
              "items": {
                "type": "object",
                "properties": {
                  "from": {
                    "type": "string",
                    "description": "The origin node identifier (format: \"level->nodeID\")."
                  },
                  "to": {
                    "type": "string",
                    "description": "The destination node identifier (format: \"level->nodeID\")."
                  },
                  "dep_depth": {
                    "type": "integer",
                    "description": "Depth of this dependency edge (distance from the root or prior stage)."
                  }
                },
                "required": [
                  "from",
                  "to",
                  "dep_depth"
                ]
              }
            },
            "node_info": {
              "type": "object",
              "description": "Dictionary of node details keyed by node identifier.",
              "additionalProperties": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Human-readable name of the node."
                  },
                  "index_values": {
                    "type": "array",
                    "description": "List of numeric indicators for this node.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "index_name": {
                          "type": "string",
                          "description": "Name of the indicator metric."
                        },
                        "value": {
                          "type": "number",
                          "description": "Numeric value of the indicator."
                        }
                      },
                      "required": [
                        "index_name",
                        "value"
                      ]
                    }
                  },
                  "company_distribution": {
                    "type": "array",
                    "description": "Distribution of companies for this node by country or region.",
                    "items": {
                      "type": "object",
                      "properties": {
                        "country": {
                          "type": "string",
                          "description": "Country or region where the companies are based."
                        },
                        "count": {
                          "type": "integer",
                          "description": "Number of companies in that country contributing to this node."
                        }
                      },
                      "required": [
                        "country",
                        "count"
                      ]
                    }
                  }
                },
                "required": [
                  "name",
                  "index_values",
                  "company_distribution"
                ]
              }
            }
          },
          "required": [
            "pid",
            "company_name",
            "max_depth",
            "dependencies",
            "node_info"
          ],
          "examples": [
            {
              "pid": "a77828f060c866441f2403384b271e63",
              "company_name": "Tesla, Inc.",
              "max_depth": 3,
              "dependencies": [
                {
                  "from": "0->-1",
                  "to": "1->1384787",
                  "dep_depth": 1
                },
                {
                  "from": "0->-1",
                  "to": "1->1683397",
                  "dep_depth": 1
                },
                {
                  "from": "0->-1",
                  "to": "1->1657001",
                  "dep_depth": 1
                }
              ],
              "node_info": {
                "1->1384787": {
                  "name": "HBM Memory",
                  "index_values": [
                    {
                      "index_name": "Number of enterprises",
                      "value": 13893
                    },
                    {
                      "index_name": "Number of enterprise software copyrights",
                      "value": 2728
                    }
                  ],
                  "company_distribution": [
                    {
                      "country": "China",
                      "count": 1213
                    },
                    {
                      "country": "Japan",
                      "count": 14
                    }
                  ]
                }
              }
            }
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured output representing the results of company's supply chain graph "
    }
  ],
  "description": "Primary agent output. Agents return text/Markdown for intermediate, failed, or user-dependent states, and structured JSON only when the task completes successfully."
}

Classifies products into correct HTS codes from text or documents, automating tariff lookup and ensuring customs compliance in real time. Pricing: {"unit": "credits", "per_run": 2}

{
  "type": "object",
  "properties": {
    "product_description": {
      "type": "string",
      "description": "Description of the product used to identify HS/HTS codes."
    }
  },
  "required": [
    "product_description"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input (e.g. validation prompts, error messages, or clarification requests)."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "result"
          ],
          "description": "Indicates structured HTS classification output."
        },
        "data": {
          "type": "object",
          "properties": {
            "country_of_origin": {
              "type": [
                "string",
                "null"
              ],
              "description": "Country of origin information extracted from the input text. Returns null if not provided or cannot be determined."
            },
            "classification_results": {
              "type": "array",
              "description": "List of possible HTS classifications with confidence and reasoning.",
              "items": {
                "type": "object",
                "properties": {
                  "hts_code": {
                    "type": "string",
                    "description": "10-digit Harmonized Tariff Schedule code."
                  },
                  "confidence_score": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                  },
                  "description": {
                    "type": "string",
                    "description": "Official HTS category description."
                  },
                  "reasoning": {
                    "type": "string",
                    "description": "AI-explained rationale for the classification choice."
                  }
                },
                "required": [
                  "hts_code",
                  "confidence_score",
                  "description",
                  "reasoning"
                ]
              }
            }
          },
          "required": [
            "classification_results",
            "country_of_origin"
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured classification output for HTS code matching results."
    }
  ],
  "description": "Primary agent output. Agents return text/Markdown for intermediate, failed, or user-dependent states, and structured JSON only when the task completes successfully."
}

Resolves natural-language country or region names (including aliases and abbreviations) against SupplyGraph’s internal geography registry and returns a list of standardized region names for downstream agent and MCP tool consumption. Pricing: {"unit": "credits", "billing_model": "per_run", "per_run": 1}

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Country or region name in natural language, including aliases and abbreviations (e.g. 'China', 'USA', 'South Korea', 'Hong Kong', '中国', '美国'). The tool searches the internal geography registry and returns standardized matching region names for caller-side selection."
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response when the task is not completed, failed, cancelled, or no match is found (e.g. clarification prompts or error messages)."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response when the task is not completed, failed, cancelled, or no match is found (e.g. clarification prompts or error messages)."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "region_candidate_search"
          ],
          "description": "Indicates structured country or region candidate search results with standardized region names."
        },
        "data": {
          "type": "object",
          "properties": {
            "candidates": {
              "type": "array",
              "description": "List of matched and standardized country or region names.",
              "items": {
                "type": "object",
                "properties": {
                  "region_name": {
                    "type": "string",
                    "description": "Standardized country or region name after internal registry matching (e.g. China, United States, Hong Kong)."
                  }
                },
                "required": [
                  "region_name"
                ]
              }
            }
          },
          "required": [
            "candidates"
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured output for resolving natural-language country or region input into standardized region names."
    }
  ],
  "description": "Primary agent output. Returns structured standardized region names for downstream resolution, or text for intermediate/error states."
}

Continuously monitors global supply chain risk events and evaluates whether, how, and to what extent those events may affect a target company. Pricing: {"unit": "credits", "per_run": 264590}

{
  "type": "object",
  "properties": {
    "event_info": {
      "type": "object",
      "description": "Evaluates how a supply chain risk event may affect a target company through multi-tier supply chain propagation analysis.",
      "additionalProperties": false,
      "properties": {
        "company_id": {
          "type": "string",
          "description": "Internal company ID for the target enterprise, obtained from the search_company_candidates MCP tool (e.g. a77828f060c866441f2403384b271e63 for Tesla, Inc.)."
        },
        "event_type": {
          "type": "string",
          "enum": [
            "news",
            "policy",
            "commodity_price"
          ],
          "description": "Type of supply chain risk event."
        },
        "analysis_mode": {
          "type": "string",
          "enum": [
            "normal",
            "backtest"
          ],
          "description": "Analysis mode. normal performs current risk assessment; backtest evaluates historical scenarios."
        },
        "role": {
          "type": "string",
          "enum": [
            "ceo",
            "hedgefund",
            "riskexpert"
          ],
          "description": "Optional role-specific interpretation mode."
        },
        "title": {
          "type": "string",
          "description": "Event title. Required for news and policy events."
        },
        "content": {
          "type": "string",
          "description": "Detailed event content. Required for news and policy events."
        },
        "pub_date": {
          "type": "string",
          "description": "Event publication time in RFC3339 format. Required for news and policy events."
        },
        "commodity_name": {
          "type": "string",
          "description": "Commodity name. Required for commodity_price events."
        },
        "commodity_unit": {
          "type": "string",
          "description": "Commodity price unit. Required for commodity_price events."
        },
        "target_date": {
          "type": "string",
          "description": "Target analysis date in YYYY-MM-DD format. Required for commodity_price events."
        },
        "target_price": {
          "type": "number",
          "description": "Commodity price on target_date. Required for commodity_price events."
        },
        "commodity_price_series": {
          "type": "array",
          "description": "Historical commodity price series. Required for commodity_price events. Must contain at least 90 calendar days.",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "date": {
                "type": "string",
                "description": "Price date in YYYY-MM-DD format."
              },
              "value": {
                "type": "number",
                "description": "Commodity price value."
              }
            },
            "required": [
              "date",
              "value"
            ]
          }
        }
      },
      "required": [
        "company_id",
        "event_type",
        "analysis_mode"
      ]
    }
  },
  "required": [
    "event_info"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input, such as company confirmation, validation prompts, error messages, or clarification requests."
        }
      },
      "required": [
        "text"
      ],
      "description": "Text or Markdown response generated by the agent. Returned when the task is not yet completed, failed, cancelled, or requires user input, such as company confirmation, validation prompts, error messages, or clarification requests."
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "enum": [
            "result"
          ],
          "description": "Indicates that the response contains structured supply chain risk prediction results."
        },
        "data": {
          "type": "object",
          "properties": {
            "event": {
              "type": "object",
              "description": "Information about the supply chain risk event being analyzed, including event type, event date, event summary, and original event context."
            },
            "company": {
              "type": "object",
              "description": "Information about the target company being assessed, including company identifier, company name, industry, and company profile information."
            },
            "assessment_result": {
              "type": "object",
              "description": "Enterprise-level supply chain risk assessment result, including task status, progress, risk summary, final interpretation, impact dates, impacted node counts, key path counts, key node counts, impact result, path-level risk interpretations, impact graph data, and analysis dossier text."
            },
            "node_assessment_list": {
              "type": "array",
              "description": "List of node-level supply chain assessment records, including evaluated suppliers, products, materials, or other supply chain nodes and their risk status."
            },
            "dossier_paragraph_list": {
              "type": "array",
              "description": "List of structured dossier paragraphs extracted from the analysis dossier, useful for section-level display, citation, export, or report generation."
            }
          },
          "required": [
            "event",
            "company",
            "assessment_result",
            "node_assessment_list",
            "dossier_paragraph_list"
          ]
        }
      },
      "required": [
        "type",
        "data"
      ],
      "description": "Structured output representing the latest available company-level supply chain risk prediction result, including event information, company information, risk assessment, impacted nodes, propagation paths, graph data, and analysis dossier content."
    }
  ],
  "description": "Primary agent output. Agents return text or Markdown for intermediate, failed, or user-dependent states, and structured JSON only when the task completes successfully."
}