{
  "$schema": "../../../schemas/tool-schemas/tool.json",
  "tool_id": "grok",
  "toolkit_id": "search_web",
  "name": "Grok",
  "description": "AI-powered deep research tool with real-time web search and X/Twitter access. Use this for comprehensive research, trending topics on X, searching social media posts, or when the owner explicitly asks for Grok.",
  "icon_name": "grok-ai-line",
  "author": {
    "name": "Louis Grenard",
    "email": "louis@getleon.ai",
    "url": "https://twitter.com/grenlouis"
  },
  "functions": {
    "listModels": {
      "description": "List available Grok models.",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    },
    "chatCompletion": {
      "description": "Create a chat completion using the Grok Responses API.",
      "parameters": {
        "type": "object",
        "properties": {
          "options": {
            "type": "object",
            "properties": {
              "input": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "role": {
                      "type": "string",
                      "enum": [
                        "system",
                        "user",
                        "assistant"
                      ]
                    },
                    "content": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "role",
                    "content"
                  ],
                  "additionalProperties": false
                }
              },
              "model": {
                "type": "string"
              },
              "temperature": {
                "type": "number"
              },
              "max_output_tokens": {
                "type": "number"
              },
              "stream": {
                "type": "boolean"
              },
              "tools": {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "web_search"
                          ]
                        },
                        "allowed_domains": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "excluded_domains": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "enable_image_understanding": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "type"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "x_search"
                          ]
                        },
                        "allowed_x_handles": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "excluded_x_handles": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "from_date": {
                          "type": "string"
                        },
                        "to_date": {
                          "type": "string"
                        },
                        "enable_image_understanding": {
                          "type": "boolean"
                        },
                        "enable_video_understanding": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "type"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              }
            },
            "required": [
              "input"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "options"
        ]
      }
    },
    "searchWeb": {
      "description": "Search the web using Grok's server-side web search tool.",
      "hooks": {
        "post_execution": {
          "response_jq": ".result.content"
        }
      },
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "options": {
            "type": "object",
            "properties": {
              "allowed_domains": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "excluded_domains": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "enable_image_understanding": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "query"
        ]
      }
    },
    "searchX": {
      "description": "Search X/Twitter using Grok's server-side X search tool.",
      "hooks": {
        "post_execution": {
          "response_jq": ".result.content"
        }
      },
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "options": {
            "type": "object",
            "properties": {
              "allowed_x_handles": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "excluded_x_handles": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "from_date": {
                "type": "string"
              },
              "to_date": {
                "type": "string"
              },
              "enable_image_understanding": {
                "type": "boolean"
              },
              "enable_video_understanding": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "query"
        ]
      }
    },
    "search": {
      "description": "Search both web and X using Grok's server-side search tools.",
      "hooks": {
        "post_execution": {
          "response_jq": ".result.content"
        }
      },
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "options": {
            "type": "object",
            "properties": {
              "web_options": {
                "type": "object",
                "properties": {
                  "allowed_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "excluded_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "enable_image_understanding": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "x_options": {
                "type": "object",
                "properties": {
                  "allowed_x_handles": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "excluded_x_handles": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "from_date": {
                    "type": "string"
                  },
                  "to_date": {
                    "type": "string"
                  },
                  "enable_image_understanding": {
                    "type": "boolean"
                  },
                  "enable_video_understanding": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "query"
        ]
      }
    },
    "deepResearch": {
      "description": "Perform deep research on a topic using web search.",
      "hooks": {
        "post_execution": {
          "response_jq": ".result.content"
        }
      },
      "parameters": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string"
          },
          "focusAreas": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "options": {
            "type": "object",
            "properties": {
              "allowed_domains": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "topic"
        ]
      }
    },
    "getTrendingOnX": {
      "description": "Get trending topics on X/Twitter.",
      "hooks": {
        "post_execution": {
          "response_jq": ".result.content"
        }
      },
      "parameters": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string"
          }
        }
      }
    }
  }
}