X (Twitter) data API and MCP for AI agents
TollNode gives Claude, Cursor or any AI agent live X (Twitter) data (post search, latest posts and profiles) over API and MCP, from $0.006 per call, no X API plan.
Ask in plain words, like 'what is Stripe posting about this week', and get a clean table back in seconds.
No subscription · Sign-up optional · From $0.006 per call · Charged only when it works · No X account needed
Pull Stripe's X profile: followers, location and how many posts
TollNode · X · profile$0.008 · 1 profile · 3.7 s
| Field | Value |
|---|---|
| Followers | 296,927 |
| Following | 560 |
| Posts | 35,814 |
| Location | San Francisco, US + Dublin, IE |
Real result.
What your agent can pull from X (Twitter)
- from $0.006
Search and posts
X (Twitter) post search API
Up to 20 posts by search query or by account handle.
- Author
- @g…
- Text
- A notary can stamp your signature...
- Likes
- 0
- Views
- 14
- Date
- Nov 8
You get
- text: the full post text
- author handle: who posted it (search only)
- author followers: poster's follower count (search only)
- likes: like count
- reposts: repost count
- replies: reply count
- quotes: quote post count
- views: view count
- date: when it was posted
- media: attached photo or video, if any
- link: URL to the post
- from $0.008
Profile
An account's bio, location, verified flag and follower counts.
- Name
- Stripe
- Handle
- @stripe
- Followers
- 296,927
- Posts
- 35,814
- Joined
- Jan 2010
You get
- name: the account's display name
- bio: the profile description
- location: self-reported location
- verified: blue check status
- followers: follower count
- following: accounts followed
- post count: total posts made
- likes: total likes given
- join date: when the account was created
Every result is structured JSON your agent can sort, filter, summarize or turn into a spreadsheet.
What people ask their AI to do with it
Marketing
Track brand mentions and sentiment
“Search X for posts mentioning Peloton this week and summarize the tone”
search
Cost today$0.006
Founders
Watch a competitor's latest posts
“Show me the last 20 posts from @Notion and summarize the themes”
posts
Cost today$0.006
Investors
Check an account's size and credibility
“Look up the X profile for @balajis and tell me follower count and bio”
profile
Cost today$0.008
Journalists
Find real-time reaction to breaking news
“Search X for posts about the Fed rate decision in the last hour”
search
Cost today$0.006
Customer support
Spot complaints about your product
“Search X for complaints about Delta Airlines flight delays today”
search
Cost today$0.006
Crypto traders
Track a project account for updates
“Get the latest posts and profile stats for @Uniswap to see recent updates”
posts + profile
Cost today$0.014
Use it as an X (Twitter) MCP server in Claude, Cursor or Codex
Connect once. Then just ask.
Paste this into Claude Code, Cursor or Codex. It connects TollNode and gives your agent a small wallet. Add a few dollars of USDC and you're done.
npx agentcash add https://tollnode.comCopy for your AI agent
Paste this into your agent so it knows what this node does and how to call it.
You can use TollNode's X (Twitter) node to look up public X data. Call POST https://tollnode.com/api/v1/nodes/x-twitter with an "action" and its fields. Actions: search (query, sortBy), posts (handle), profile (handle). Each action has its own price and is charged only when it returns a result. Over MCP, call the "x-twitter" tool; use list_models to see prices. Return results as tables when I ask for lists.3 actions, one node
Send action plus the fields that action needs, to the same address. Each action has its own price, charged only when it returns a result. Leave out action and you get search.
- search$0.006
20 recent posts for a query. 20 posts: text, author handle and follower count, likes, reposts, replies, quotes, views, date, media and link..
needs: query · optional: sortBy
- posts$0.006
An account's latest 20 posts. 20 posts: text, likes, reposts, replies, quotes, views, date, media and link..
needs: handle
- profile$0.008
An account's profile and follower counts. Name, bio, location, verified flag, followers, following, post count, likes and join date..
needs: handle
{"action":"search","query":"x402 payments"}{"action":"posts","handle":"natgeo"}POST either body to https://tollnode.com/api/v1/nodes/x-twitter. From an AI assistant you don't write this yourself: ask in plain words and it picks the action.
Charged only when a call returns a result. Failed or empty calls cost $0.
X data without an X API plan
No subscription, no monthly tier
Pay per action: a 20-post search is $0.006, a profile lookup is $0.008.
No X account, no API key, no developer app
Your own account is never touched.
Only charged when it works
If a search or handle returns nothing, it costs nothing.
One connection, much more than X
The same setup also gives your agent Reddit, TikTok, Instagram, LinkedIn and image or video models.
FAQ
- Is this the official X (Twitter) API?
- No. The official X API is sold in monthly tiers. TollNode returns public X data (search, posts and profiles) through its own API and MCP server, priced per call, so you only pay for the lookups you make.
- Can I use it as an X (Twitter) MCP server in Claude?
- Yes. Add https://tollnode.com/mcp in Claude Code, Claude Desktop or Cursor, and the "x-twitter" tool appears with every action and its price.
- Do I need an X account or API key?
- No. Your agent calls TollNode, and you never log in to X or register a developer app.
- What if a search comes back empty?
- You're not charged. The response shows no results, and your agent can try a different query or handle.
- Can I get a full follower list?
- No. This node returns follower and following counts, not lists of individual followers. It also doesn't cover private accounts or direct messages.
- How much data comes back per call?
- Search and posts each return up to 20 posts. Profile returns one account's bio and counts. Ask for another call to get more recent posts.
- What can I use it for?
- Research, brand monitoring, sentiment checks and tracking an account's activity using public posts. You're responsible for using the data in line with applicable laws.
Works well with
Ready in a minute
Connect your AIFor developers: endpoint, inputs and an example response
POST https://tollnode.com/api/v1/nodes/x-twitter
Input
| Field | Type | Notes |
|---|---|---|
| query | string | Search query; X search operators work, e.g. x402 payments, #bitcoin, from:nasa (for: search) |
| action* | enum | What to do; sets the price. search (needs query), posts (needs handle), profile (needs handle). Default search (search, posts, profile) |
| handle | string | Account handle without @, e.g. NatGeo (for: posts, profile) |
| sortBy | enum | Optional, default Latest (for: search) (Latest, Top) |
Example response
{
"results": [
{
"id": "2119501456730403300",
"url": "https://x.com/GREATVVIP/status/2119501456730403300",
"edit": {
"editTweetIds": [
"2119501456730403300"
],
"editableUntilMsecs": "1794167100000"
},
"lang": "en",
"text": "A notary can stamp your signature. 𝗔 𝗻𝗼𝘁𝗮𝗿𝘆 𝗰𝗮𝗻'𝘁 𝗰𝗵𝗮𝗻𝗴𝗲 𝗮 𝘀𝗶𝗻𝗴𝗹𝗲 𝘄𝗼𝗿𝗱 𝗼𝗳 𝘄𝗵𝗮𝘁 𝘆𝗼…",
"type": "tweet",
"isReply": false,
"entities": {
"urls": [],
"hashtags": [
{}
],
"user_mentions": [
{}
]
},
"isPinned": false,
"createdAt": "Sun Nov 08 18:45:00 +0000 2026",
"isRetweet": false,
"likeCount": 0,
"noteTweet": {
"id": "Tm90ZVR3ZWV0OjIxMTk1MDE0NTY1NjI1ODU2MDA=",
"text": "A notary can stamp your signature. 𝗔 𝗻𝗼𝘁𝗮𝗿𝘆 𝗰𝗮𝗻'𝘁 𝗰𝗵𝗮𝗻𝗴𝗲 𝗮 𝘀𝗶𝗻𝗴𝗹𝗲 𝘄𝗼𝗿𝗱 𝗼𝗳 𝘄𝗵𝗮𝘁 𝘆𝗼…",
"noteId": "2119501456562585600",
"entities": {
"urls": [],
"hashtags": [
{}
],
"user_mentions": [
{}
]
},
"isExpandable": true
},
"viewCount": 14,
"viewState": "EnabledWithCount",
"quoteCount": 0,
"replyCount": 0,
"isNoteTweet": true,
"retweetCount": 0,
"bookmarkCount": 0,
"isQuoteStatus": false,
"conversationId": "2119501456730403300",
"isTranslatable": false,
"textHighlights": [
{
"endIndex": 144,
"startIndex": 140
}
],
"displayTextRange": [
0
],
"possiblySensitive": false
}
]
}Also described in the OpenAPI file and llms.txt. Setup for every app: Agents & MCP.