> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X Search

> Search X/Twitter posts and content through Grok's native x_search tool

X Search lets a Grok-powered agent search posts and content on X, formerly Twitter, while it responds.

## What it does

This tool uses xAI's native `x_search` capability. It can help an agent find recent posts, discussions, and threads on X without connecting a separate MCP server.

## Requirements

X Search is only available when your agent is configured to use an **xAI (Grok)** model. When your agent uses a different model provider, use [GPT Search](./gpt-search), [Google Search](./google-search), or [xAI Web Search](./xai-search) where appropriate.

## Adding the tool to an agent

1. Open an agent in the editor.
2. Make sure the agent's model is set to an xAI Grok model.
3. Click the button with the tooltip **Add MCP Tool or Sub Agent**.
4. In **MCP Tools**, click **X Search**.

## Configuration

X Search settings are configured in the MCP tool settings sheet:

| Parameter                    | Description                                                                        |
| ---------------------------- | ---------------------------------------------------------------------------------- |
| `allowed_x_handles`          | Only consider posts from specific X handles (max 20). The default is blank.        |
| `excluded_x_handles`         | Exclude posts from specific X handles (max 20). The default is blank.              |
| `included_domains`           | Prefer or limit linked content to specific domains (max 20). The default is blank. |
| `excluded_domains`           | Exclude linked content from specific domains (max 20). The default is blank.       |
| `from_date`                  | Start date for search range (`YYYY-MM-DD`). The default is blank.                  |
| `to_date`                    | End date for search range (`YYYY-MM-DD`). The default is blank.                    |
| `enable_image_understanding` | Enable analysis of images in posts. The default is disabled.                       |
| `enable_video_understanding` | Enable analysis of videos in posts. The default is disabled.                       |

Notes:

* `Allowed X Handles` and `Excluded X Handles` are mutually exclusive.
* Dates must be valid ISO date strings (`YYYY-MM-DD`).

## Use cases

* Monitor what people are saying about a company, product, topic, or event on X.
* Find recent posts and threads before answering a time-sensitive question.
* Gather social context and public reactions from X content.

## Billing

X Search is billed at **\$0.005 per completed request/tool call**.

## Notes

* X Search searches X/Twitter posts and content. For public web results from Grok, use [xAI Web Search](./xai-search).
* This tool is powered by xAI's native `x_search` capability, not an external MCP server.
* Use **Chat** in the editor to see when the agent calls **X Search** during a test run. See [Testing with Chat](../testing-with-chat).