{
  "schema_version": "sourcestrand-agent-tools-v1",
  "generated_at": "2026-07-13T07:48:22.625Z",
  "gateway": "SourceStrand Data Gateway",
  "base_url": "https://api.sourcestrand.com",
  "canonical_base_url": "https://api.sourcestrand.com",
  "openapi_url": "https://api.sourcestrand.com/openapi.json",
  "copilot_openapi_url": "https://api.sourcestrand.com/openapi.copilot.json",
  "ai_offer_url": "https://api.sourcestrand.com/ai-offer.json",
  "assistant_compatibility_url": "https://api.sourcestrand.com/assistant-compatibility.json",
  "x402_resources_url": "https://api.sourcestrand.com/.well-known/x402/resources.json",
  "route_intent_url_template": "https://api.sourcestrand.com/v1/agent/route-intent?query={buyer_question}",
  "agent_flow": [
    "Call route_intent first when the buyer question is ambiguous.",
    "Call the suggested free preview endpoint and inspect limitations, data_lineage, and freshness_policy.",
    "Call payment_intent_url_template from /ai-offer.json for human approval before x402 payment.",
    "Retry the same paid resource with x-payment only after buyer authority is available."
  ],
  "safety_boundaries": {
    "not_legal_advice": true,
    "not_financial_advice": true,
    "not_procurement_advice": true,
    "not_compliance_clearance": true,
    "no_private_keys": "Never send wallet private keys to SourceStrand."
  },
  "integration_examples": {
    "curl_preview": "curl -s \"https://api.sourcestrand.com/v1/preview/tw-data-packs/trade-import-export?buyer_hint=agent-docs\"",
    "curl_payment_intent": "curl -s \"https://api.sourcestrand.com/v1/payment/intent?resource_url=https%3A%2F%2Fapi.sourcestrand.com%2Fv1%2Fpaid%2Ftw-data-packs%2Ftrade-import-export%3Fbuyer_hint%3Dagent-docs\"",
    "js_fetch_preview": "const preview = await fetch(\"https://api.sourcestrand.com/v1/preview/tw-data-packs/trade-import-export?buyer_hint=agent-docs\").then((r) => r.json());",
    "python_preview": "import requests\npreview = requests.get(\"https://api.sourcestrand.com/v1/preview/tw-data-packs/trade-import-export\", params={\"buyer_hint\":\"agent-docs\"}).json()",
    "openai_tool_flow": [
      "Use route_intent(query) to choose the first free preview.",
      "Call the preview URL and inspect freshness_policy, sample_records, source_hash, data_lineage, and limitations.",
      "If the buyer approves payment, call payment_intent_url_template from /ai-offer.json for the selected paid resource.",
      "Retry the exact paid resource with an x402-compatible client and preserve x-buyer-hint."
    ]
  },
  "assistant_compatibility": {
    "supported_top_assistants": [
      "ChatGPT",
      "Google Gemini",
      "Perplexity",
      "Claude",
      "Microsoft Copilot"
    ],
    "manifest_url": "https://api.sourcestrand.com/assistant-compatibility.json",
    "function_call_tools_url": "https://api.sourcestrand.com/assistant-compatibility.json#function_call_tools",
    "copilot_openapi_url": "https://api.sourcestrand.com/openapi.copilot.json",
    "note": "Use assistant-compatibility before importing into a specific assistant so ChatGPT, Gemini, Claude, Perplexity, and Microsoft Copilot each receive the right schema shape."
  },
  "function_call_tools": [
    {
      "name": "sourcestrand_route_intent",
      "description": "Route a natural-language buyer question to the safest SourceStrand free preview and matching paid endpoint template. Call this first when the user asks for Taiwan suppliers, semiconductor companies, trade context, compliance context, or crypto asset context but has not chosen an endpoint.",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/agent/route-intent?query={query}",
      "safe_to_call_without_payment": true,
      "parameters": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "query": {
            "type": "string",
            "minLength": 2,
            "maxLength": 240,
            "description": "The user's buyer question, for example 'Taiwan semiconductor supplier packaging' or 'HS 8542 Taiwan export demand'."
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "sourcestrand_preview_taiwan_data_pack",
      "description": "Fetch a free preview of a record-backed Taiwan buyer pack. Use this before payment to inspect sample records, source lineage, freshness, limitations, agent_cache, and paid_unlock metadata.",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/preview/tw-data-packs/{pack}",
      "safe_to_call_without_payment": true,
      "parameters": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "pack": {
            "type": "string",
            "enum": [
              "supplier-discovery",
              "trade-import-export",
              "regulated-supplier-compliance",
              "export-control-screening",
              "factory-operational-risk",
              "public-company-signals",
              "compliance-risk"
            ],
            "description": "Taiwan data pack slug selected from route_intent or from the buyer's task."
          },
          "buyer_hint": {
            "type": "string",
            "description": "Optional stable attribution handle for the assistant, partner, or campaign."
          }
        },
        "required": [
          "pack"
        ]
      }
    },
    {
      "name": "sourcestrand_preview_company_dossier",
      "description": "Preview how SourceStrand can stitch Taiwan company brief, procurement, semiconductor, entity graph, trade, compliance, and factory context after resolving a business_id or company name.",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/preview/tw-company/dossier?query={query}",
      "safe_to_call_without_payment": true,
      "parameters": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "query": {
            "type": "string",
            "minLength": 2,
            "maxLength": 160,
            "description": "Taiwan business_id, company name, or alias."
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "sourcestrand_preview_data_pack_changes",
      "description": "Preview repeat-refresh and change-feed fields for a Taiwan data pack. Use this when an assistant wants to monitor updates before recommending a paid pack or watchlist workflow.",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/preview/changes/tw-data-packs?pack={pack}&since={since}",
      "safe_to_call_without_payment": true,
      "parameters": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "pack": {
            "type": "string",
            "enum": [
              "supplier-discovery",
              "trade-import-export",
              "regulated-supplier-compliance",
              "export-control-screening",
              "factory-operational-risk",
              "public-company-signals",
              "compliance-risk"
            ]
          },
          "since": {
            "type": "string",
            "description": "Optional ISO datetime. Use previous_successful_fetch when no timestamp is available."
          }
        }
      }
    },
    {
      "name": "sourcestrand_preview_watchlist",
      "description": "Turn a company, sector, or buyer topic into suggested watch keys and repeat-refresh follow-ups across SourceStrand Taiwan data products.",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/preview/watchlist/tw-data-products?query={query}",
      "safe_to_call_without_payment": true,
      "parameters": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "query": {
            "type": "string",
            "minLength": 2,
            "maxLength": 160,
            "description": "Company, sector, data-pack topic, or buyer monitoring goal."
          }
        },
        "required": [
          "query"
        ]
      }
    },
    {
      "name": "sourcestrand_payment_intent",
      "description": "Create a payment intent for a selected x402 paid resource. Use only after a free preview confirms fit. If the assistant does not have explicit buyer payment authority, return approval_url to the human buyer instead of paying automatically.",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/payment/intent?resource_url={urlencoded_paid_resource_url}",
      "safe_to_call_without_payment": true,
      "parameters": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "resource_url": {
            "type": "string",
            "description": "Full SourceStrand paid resource URL selected from route_intent or preview paid_unlock metadata."
          }
        },
        "required": [
          "resource_url"
        ]
      }
    }
  ],
  "tools": [
    {
      "tool_id": "route_intent",
      "title": "Route a buyer question to the best free preview and paid endpoint",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/agent/route-intent?query={buyer_question}",
      "payment_required": false
    },
    {
      "tool_id": "preview_company_dossier",
      "title": "Preview a cross-product Taiwan company dossier route",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/preview/tw-company/dossier?query={business_id_or_name}",
      "payment_required": false
    },
    {
      "tool_id": "preview_data_pack_changes",
      "title": "Preview Taiwan data-pack change-feed fields",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/preview/changes/tw-data-packs?pack={pack_slug}&since={iso_datetime}",
      "payment_required": false
    },
    {
      "tool_id": "preview_taiwan_watchlist",
      "title": "Preview watchlist setup for repeat buyer updates",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/preview/watchlist/tw-data-products?query={company_or_sector}",
      "payment_required": false
    },
    {
      "tool_id": "preview_tw_supplier_discovery_pack",
      "product_id": "tw_supplier_discovery_pack",
      "title": "Taiwan Supplier Discovery Pack",
      "when_to_use": "Which Taiwan official-source streams should an AI assistant use for supplier discovery, factory presence, public-company context, and market entry preflight?",
      "method": "GET",
      "free_preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/supplier-discovery",
      "paid_url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/supplier-discovery",
      "price": "$0.03",
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "buyer_hint": {
            "type": "string",
            "description": "Optional attribution handle for agent, partner, or campaign."
          }
        }
      },
      "output_contract": {
        "preserves": [
          "metadata.source_model",
          "metadata.last_updated_at",
          "source_hash",
          "data_lineage",
          "limitations",
          "freshness_policy",
          "agent_cache"
        ],
        "preview_first": true,
        "payment_required_for_full_pack": true
      }
    },
    {
      "tool_id": "preview_tw_trade_import_export_pack",
      "product_id": "tw_trade_import_export_pack",
      "title": "Taiwan Trade Import/Export Buyer Pack",
      "when_to_use": "Which Taiwan importer/exporter, customs, and HS-country trade streams help a buyer or AI assistant identify cross-border supplier leads and product-category demand context?",
      "method": "GET",
      "free_preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/trade-import-export",
      "paid_url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/trade-import-export",
      "price": "$0.03",
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "buyer_hint": {
            "type": "string",
            "description": "Optional attribution handle for agent, partner, or campaign."
          }
        }
      },
      "output_contract": {
        "preserves": [
          "metadata.source_model",
          "metadata.last_updated_at",
          "source_hash",
          "data_lineage",
          "limitations",
          "freshness_policy",
          "agent_cache"
        ],
        "preview_first": true,
        "payment_required_for_full_pack": true
      }
    },
    {
      "tool_id": "preview_tw_regulated_supplier_compliance_pack",
      "product_id": "tw_regulated_supplier_compliance_pack",
      "title": "Taiwan Regulated Supplier Compliance Pack",
      "when_to_use": "Which Taiwan food, medical-device, and public nonconformity streams should a buyer or AI assistant inspect before deeper regulated supplier diligence?",
      "method": "GET",
      "free_preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/regulated-supplier-compliance",
      "paid_url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/regulated-supplier-compliance",
      "price": "$0.03",
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "buyer_hint": {
            "type": "string",
            "description": "Optional attribution handle for agent, partner, or campaign."
          }
        }
      },
      "output_contract": {
        "preserves": [
          "metadata.source_model",
          "metadata.last_updated_at",
          "source_hash",
          "data_lineage",
          "limitations",
          "freshness_policy",
          "agent_cache"
        ],
        "preview_first": true,
        "payment_required_for_full_pack": true
      }
    },
    {
      "tool_id": "preview_tw_export_control_screening_pack",
      "product_id": "tw_export_control_screening_pack",
      "title": "Taiwan Export-Control Screening Pack",
      "when_to_use": "Which Taiwan export-control, importer/exporter, product-safety, and public-company streams help a buyer or AI assistant perform public-record counterparty screening?",
      "method": "GET",
      "free_preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/export-control-screening",
      "paid_url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/export-control-screening",
      "price": "$0.03",
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "buyer_hint": {
            "type": "string",
            "description": "Optional attribution handle for agent, partner, or campaign."
          }
        }
      },
      "output_contract": {
        "preserves": [
          "metadata.source_model",
          "metadata.last_updated_at",
          "source_hash",
          "data_lineage",
          "limitations",
          "freshness_policy",
          "agent_cache"
        ],
        "preview_first": true,
        "payment_required_for_full_pack": true
      }
    },
    {
      "tool_id": "preview_tw_factory_operational_risk_pack",
      "product_id": "tw_factory_operational_risk_pack",
      "title": "Taiwan Factory Operational Risk Pack",
      "when_to_use": "Which Taiwan factory, grid, drought, air-quality, and environmental streams help a buyer or AI assistant add operational context around supplier sites?",
      "method": "GET",
      "free_preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/factory-operational-risk",
      "paid_url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/factory-operational-risk",
      "price": "$0.03",
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "buyer_hint": {
            "type": "string",
            "description": "Optional attribution handle for agent, partner, or campaign."
          }
        }
      },
      "output_contract": {
        "preserves": [
          "metadata.source_model",
          "metadata.last_updated_at",
          "source_hash",
          "data_lineage",
          "limitations",
          "freshness_policy",
          "agent_cache"
        ],
        "preview_first": true,
        "payment_required_for_full_pack": true
      }
    },
    {
      "tool_id": "preview_tw_public_company_signals_pack",
      "product_id": "tw_public_company_signals_pack",
      "title": "Taiwan Public Company Signals Pack",
      "when_to_use": "Which Taiwan listed-company profile, revenue, ESG, patent, and risk-policy streams help a buyer or AI assistant enrich public-company research without investment advice?",
      "method": "GET",
      "free_preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/public-company-signals",
      "paid_url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/public-company-signals",
      "price": "$0.03",
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "buyer_hint": {
            "type": "string",
            "description": "Optional attribution handle for agent, partner, or campaign."
          }
        }
      },
      "output_contract": {
        "preserves": [
          "metadata.source_model",
          "metadata.last_updated_at",
          "source_hash",
          "data_lineage",
          "limitations",
          "freshness_policy",
          "agent_cache"
        ],
        "preview_first": true,
        "payment_required_for_full_pack": true
      }
    },
    {
      "tool_id": "preview_tw_compliance_risk_pack",
      "product_id": "tw_compliance_risk_pack",
      "title": "Taiwan Compliance & Public Risk Pack",
      "when_to_use": "Which Taiwan official-source streams help a buyer or AI assistant screen public compliance events, site flags, labor events, export controls, and ESG risk disclosures?",
      "method": "GET",
      "free_preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/compliance-risk",
      "paid_url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/compliance-risk",
      "price": "$0.03",
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "buyer_hint": {
            "type": "string",
            "description": "Optional attribution handle for agent, partner, or campaign."
          }
        }
      },
      "output_contract": {
        "preserves": [
          "metadata.source_model",
          "metadata.last_updated_at",
          "source_hash",
          "data_lineage",
          "limitations",
          "freshness_policy",
          "agent_cache"
        ],
        "preview_first": true,
        "payment_required_for_full_pack": true
      }
    },
    {
      "tool_id": "preview_crypto_asset_signal",
      "product_id": "crypto_agent_signals",
      "title": "Crypto asset signal preview",
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/preview/crypto/asset-signal?asset={BTC|ETH|SOL|SUI|ADA}",
      "paid_url_template": "https://api.sourcestrand.com/v1/paid/crypto/asset-signal?asset={asset}",
      "payment_required": false,
      "boundary": "Informational market context only; not trading advice."
    }
  ]
}