What Can It Do?
- Search tweets by keyword, user, or date
- Post and manage tweets without leaving your workflow
- Track mentions and engagement
- Manage followers and bookmarks
Where to Use It
In Agents (Recommended)
Add X as a tool to any agent. The agent can then manage your X presence conversationally, choosing the right actions based on context. To add an MCP tool to your agent:- Open your agent’s configuration
- Click Add tools → Connect an app with MCP
- Search for the integration and select it
- Authenticate with your account
In Workflows (Via Agent Node)
For automated pipelines, use an Agent Node with X tools. This gives you the flexibility of an agent within a deterministic workflow.As a Custom MCP Node
You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.- Go to your node library and search for the integration
- Click Create a node with AI
- Describe the specific action you want (e.g., “Search tweets about AI automation”)
- Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.
Available Tools
| Tool | Description |
|---|---|
| Search Tweets | Search tweets by query |
| Get User Tweets | Get tweets from a user |
| Get User Mentions | Get tweets mentioning a user |
| Get User Timeline | Get your home timeline |
| Create Tweet | Post a new tweet |
| Delete Tweet | Delete a tweet |
| Get Bookmarks | Get bookmarked tweets |
| Create Bookmark | Bookmark a tweet |
| Get Followers | Get user’s followers |
| Get Following | Get accounts a user follows |
| Manage Follow | Follow or unfollow a user |
| Get Trends By WOEID | Get trending topics |
Example Prompts
Use these with your agent or in the Agent Node: Search tweets:Troubleshooting
| Issue | Solution |
|---|---|
| Agent not finding the right data | Use specific keywords or user handles |
| Action not completing | Check that you’ve authenticated with X |
| Unexpected results | The agent may chain multiple tools (e.g., searching first, then getting details). Review the agent’s reasoning to understand its approach. |
| Tool not available | Verify the tool is enabled in your agent’s MCP configuration |
Need Help?
- Agents documentation for setup and best practices
- Agent Node guide for workflow integration
- Gumloop Community for questions and examples
- Contact [email protected] for assistance
Use this integration directly in Claude or Cursor. Connect remotely via the X MCP server using your Gumloop credentials.