> For the complete documentation index, see [llms.txt](https://whitepaper.aitech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.aitech.io/agentforge/tools/x.md).

# x

[X](https://x.com/) (formerly Twitter) is a popular social media platform that enables real-time communication, content sharing, and engagement with audiences worldwide.

The X integration in Agent Forge leverages OAuth authentication to securely connect with the X API, allowing your agents to interact with the platform programmatically. This OAuth implementation ensures secure access to X's features while maintaining user privacy and security.

With the X integration, your agents can:

* **Post content**: Create new tweets, reply to existing conversations, or share media directly from your workflows
* **Monitor conversations**: Track mentions, keywords, or specific accounts to stay informed about relevant discussions
* **Engage with audiences**: Automatically respond to mentions, direct messages, or specific triggers
* **Analyze trends**: Gather insights from trending topics, hashtags, or user engagement patterns
* **Research information**: Search for specific content, user profiles, or conversations to inform agent decisions

By connecting Agent Forge with X via OAuth, you can build intelligent agents that maintain a consistent and responsive social media presence while adhering to platform policies and API best practices.

## Usage Instructions

Connect with X to post tweets, read content, search for information, and access user profiles. Integrate social media capabilities into your workflow with comprehensive X platform access.

## Tools

### `x_write`

Post new tweets, reply to tweets, or create polls on X (Twitter)

#### Input

| Parameter     | Type   | Required | Description                               |
| ------------- | ------ | -------- | ----------------------------------------- |
| `accessToken` | string | Yes      | X OAuth access token                      |
| `text`        | string | Yes      | The text content of your tweet            |
| `replyTo`     | string | No       | ID of the tweet to reply to               |
| `mediaIds`    | array  | No       | Array of media IDs to attach to the tweet |
| `poll`        | object | No       | Poll configuration for the tweet          |

#### Output

| Parameter      | Type | Description        |
| -------------- | ---- | ------------------ |
| `tweet`        | json | Tweet data         |
| `replies`      | any  | Tweet replies      |
| `context`      | any  | Tweet context      |
| `tweets`       | json | Tweets data        |
| `includes`     | any  | Additional data    |
| `meta`         | json | Response metadata  |
| `user`         | json | User profile data  |
| `recentTweets` | any  | Recent tweets data |

### `x_read`

Read tweet details, including replies and conversation context

#### Input

| Parameter        | Type    | Required | Description                             |
| ---------------- | ------- | -------- | --------------------------------------- |
| `accessToken`    | string  | Yes      | X OAuth access token                    |
| `tweetId`        | string  | Yes      | ID of the tweet to read                 |
| `includeReplies` | boolean | No       | Whether to include replies to the tweet |

#### Output

| Parameter      | Type | Description        |
| -------------- | ---- | ------------------ |
| `tweet`        | json | Tweet data         |
| `replies`      | any  | Tweet replies      |
| `context`      | any  | Tweet context      |
| `tweets`       | json | Tweets data        |
| `includes`     | any  | Additional data    |
| `meta`         | json | Response metadata  |
| `user`         | json | User profile data  |
| `recentTweets` | any  | Recent tweets data |

### `x_search`

Search for tweets using keywords, hashtags, or advanced queries

#### Input

| Parameter     | Type   | Required | Description                                                 |
| ------------- | ------ | -------- | ----------------------------------------------------------- |
| `accessToken` | string | Yes      | X OAuth access token                                        |
| `query`       | string | Yes      | Search query (supports X search operators)                  |
| `maxResults`  | number | No       | Maximum number of results to return (default: 10, max: 100) |
| `startTime`   | string | No       | Start time for search (ISO 8601 format)                     |
| `endTime`     | string | No       | End time for search (ISO 8601 format)                       |
| `sortOrder`   | string | No       | Sort order for results (recency or relevancy)               |

#### Output

| Parameter      | Type | Description        |
| -------------- | ---- | ------------------ |
| `tweet`        | json | Tweet data         |
| `replies`      | any  | Tweet replies      |
| `context`      | any  | Tweet context      |
| `tweets`       | json | Tweets data        |
| `includes`     | any  | Additional data    |
| `meta`         | json | Response metadata  |
| `user`         | json | User profile data  |
| `recentTweets` | any  | Recent tweets data |

### `x_user`

Get user profile information

#### Input

| Parameter     | Type   | Required | Description                            |
| ------------- | ------ | -------- | -------------------------------------- |
| `accessToken` | string | Yes      | X OAuth access token                   |
| `username`    | string | Yes      | Username to look up (without @ symbol) |

#### Output

| Parameter      | Type | Description        |
| -------------- | ---- | ------------------ |
| `tweet`        | json | Tweet data         |
| `replies`      | any  | Tweet replies      |
| `context`      | any  | Tweet context      |
| `tweets`       | json | Tweets data        |
| `includes`     | any  | Additional data    |
| `meta`         | json | Response metadata  |
| `user`         | json | User profile data  |
| `recentTweets` | any  | Recent tweets data |

## Notes

* Category: `tools`
* Type: `x`