Search and data
X for AI agents.
One API key, ready-made tools.
Search recent posts on X, read posts and look up accounts and their timelines, reached with your Agent200 API key.
About X
With the X connector, your agent searches recent posts, reads single posts and looks up accounts and what they have posted. It is reached with your project’s Agent200 API key, so there is no separate X key to collect, store or rotate.
X, formerly Twitter, is a social network for short public posts, news and conversation.
Tools
What your agent can do in X.
Each tool is a capability the model can call. You decide which ones a project allows, and your Agent200 API key reaches them.
-
Search recent posts
Readx_search_postsFind posts from the last seven days that match a query.
-
Get a post
Readx_get_postRead a post with its author and engagement counts.
-
Get a user
Readx_get_userLook up an account by username: name, bio and follower counts.
-
List a user's posts
Readx_list_user_postsRead the most recent posts from an account.
No tool matches that search.
Control
Limits you can set.
You decide what your agent may do in X, and Agent200 runs every call within those limits.
-
Turn single tools on or off
Allow
x_search_postsandx_get_post, and switch offx_list_user_postsif your agent should not follow particular accounts. -
Restrict what the agent reaches
Choose the endpoints a project may use. A call outside them is refused.
Get started
Connect X
in two steps.
-
1
Set up the SDK
Add the Agent200 SDK to the codebase you already have and authenticate with your API key. The key covers every connector enabled for the project.
agent.jsConceptual exampleSet up the SDK with the Agent200 API key // One Agent200 API key covers every connector enabled for the project. const agent200 = new Agent200({ apiKey: process.env.AGENT200_API_KEY, }); -
2
Run with the X tools
Name the model and the tools. The model decides which X tools to call, and Agent200 executes them with your Agent200 API key.
run.jsConceptual exampleRun a request with the connector's tools const result = await agent200 .user("user_123") .run({ model: "openai/gpt-5.6-sol", input: "What are people posting about our launch today", tools: ["x"], }); console.log(result.output);
For agents
Instructions for AI agents.
Using a coding agent? Paste this brief into it, or give it the address of this page. It describes the X connector and how to use it.
Connector: X, through Agent200. In code: "x". What it does: Search recent posts on X, read posts and look up accounts and their timelines, reached with your Agent200 API key. Page: https://www.agent200.com/tools/x/ 1. Get an Agent200 API key. If the developer has none, send them to https://agent200.com/platform/apikeys/ and ask them to choose "Create an API key". Read the key from the AGENT200_API_KEY environment variable. Never ask for it in chat, and never write it into code, prompts or logs. 2. Agent200 reaches X with the project's Agent200 API key. No separate X key is needed. 3. Read tools: x_search_posts, x_get_post, x_get_user, x_list_user_posts. Name "x" in the tools of a request; the model decides which tool to call. 4. Stay within the project's settings. If a tool is turned off or a call is refused, tell the user. Do not work around it. 5. Before a write, confirm with the user, unless they asked for that exact change. 6. For setup with a specific framework, follow its guide: https://www.agent200.com/tools/x/framework/claude/ https://www.agent200.com/tools/x/framework/chatgpt/ https://www.agent200.com/tools/x/framework/claude-code/ https://www.agent200.com/tools/x/framework/muse/ https://www.agent200.com/tools/x/framework/grok-bot/ https://www.agent200.com/tools/x/framework/openai-dots/ https://www.agent200.com/tools/x/framework/claude-duet/ https://www.agent200.com/tools/x/framework/hermes-agent/ https://www.agent200.com/tools/x/framework/openclaw/ The code on the connector page is a conceptual example of the SDK. SDK reference: https://docs.igpt.ai/
This page is also available as Markdown, for agents and LLMs: /tools/x.md
Guides
Use X with the AI you build on.
Step-by-step setup for X with a specific model, assistant or agent framework.
-
X + Claude
How to connect X to Claude
-
X + ChatGPT
How to connect X to ChatGPT
-
X + Claude Code
How to connect X to Claude Code
-
X + Muse
How to connect X to Muse
-
X + Grok Bot
How to connect X to Grok Bot
-
X + OpenAI Dots
How to connect X to OpenAI Dots
-
X + Claude Duet
How to connect X to Claude Duet
-
X + Hermes Agent
How to connect X to Hermes Agent
-
X + OpenClaw
How to connect X to OpenClaw
FAQ
X and Agent200, answered.
Do I need my own X API key?
No. Your Agent200 API key reaches X, so there is no separate provider key to collect, store or rotate.
Can I limit what my agent can do in X?
Yes. You choose which services, endpoints and authorization scopes are allowed in your Agent200 configuration, and the agent works only within them.