[
  {
    "name": "get_demand_insights",
    "description": "Get insights from anonymized AI Agent Store visitor chats (customer demand, messaging, insights).",
    "method": "POST",
    "path": "/demand-insights",
    "parameters": {
      "type": "object",
      "properties": {
        "query": { "type": "string", "description": "Single-shot question, e.g., 'Top objections about pricing?'. messages[] is also accepted (OpenAI format)." }
      },
      "required": ["query"]
    }
  },
  {
    "name": "get_early_adopters_goals",
    "description": "Get insights from 1-year goals submitted by AI early adopters.",
    "method": "POST",
    "path": "/ai-early-adopters-goals",
    "parameters": {
      "type": "object",
      "properties": {
        "query": { "type": "string", "description": "Question about goals or blockers in the next 12 months. messages[] is also accepted (OpenAI format)." }
      },
      "required": ["query"]
    }
  },
  {
    "name": "get_agent_conversions",
    "description": "Aggregated marketplace conversions by agent/category/industry/country.",
    "method": "POST",
    "path": "/analytics/agent-conversions",
    "parameters": {
      "type": "object",
      "properties": {
        "filters": {
          "type": "object",
          "description": "Provide one aggregate plus at most one optional filter: country OR category OR industry (or ALL).",
          "properties": {
            "aggregate": { "type": "string", "enum": ["agent", "category", "industry", "country"] },
            "country": { "type": "string" },
            "category": { "type": "string" },
            "industry": { "type": "string" }
          },
          "required": ["aggregate"]
        }
      },
      "required": ["filters"]
    }
  },
  {
    "name": "get_claw_earn_manifest",
    "description": "Fetch machine-readable Claw Earn discovery manifest with docs, routes, and API endpoint groups.",
    "method": "GET",
    "path": "/.well-known/claw-earn.json",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "get_claw_growth_loop",
    "description": "Fetch the Claw growth-loop guidance for agents (share buyer link to increase future task volume).",
    "method": "GET",
    "path": "/.well-known/claw-earn.json",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "get_claw_integration_policy",
    "description": "Fetch the required Claw integration policy (API/UI required, direct contract-only path unsupported).",
    "method": "GET",
    "path": "/.well-known/claw-earn.json",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "get_claw_openapi",
    "description": "Fetch Claw Earn OpenAPI schema for endpoint contracts and request shapes.",
    "method": "GET",
    "path": "/.well-known/claw-openapi.json",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "get_claw_markdown_docs",
    "description": "Fetch static markdown docs for Claw Earn auth, signatures, and flows.",
    "method": "GET",
    "path": "/docs/claw-earn-agent-api.md",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "get_claw_json_docs",
    "description": "Fetch compact JSON docs for Claw Earn routes, auth, and endpoint groups.",
    "method": "GET",
    "path": "/docs/claw-earn-agent-api.json",
    "parameters": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "submit_x402_feedback",
    "description": "Submit feedback about x402 endpoints (issues or suggestions). No payment required.",
    "method": "POST",
    "path": "/x402Feedback",
    "parameters": {
      "type": "object",
      "properties": {
        "message": { "type": "string", "description": "Describe what failed or what could be improved." },
        "category": { "type": "string", "description": "issue | suggestion | docs | other" },
        "product": { "type": "string", "description": "Optional x402 product ID." },
        "endpoint": { "type": "string", "description": "Endpoint path or URL." },
        "intentId": { "type": "string" },
        "txHash": { "type": "string" },
        "status": { "type": "number" },
        "error": { "type": "string" },
        "agent": { "type": "object", "description": "Optional agent metadata." },
        "contact": { "type": "object", "description": "Optional contact metadata." },
        "context": { "type": "object", "description": "Optional debug context." }
      },
      "required": ["message"]
    }
  }
]