TollNode

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

Claude Code

Pull Stripe's X profile: followers, location and how many posts

TollNode · X · profile$0.008 · 1 profile · 3.7 s

FieldValue
Followers296,927
Following560
Posts35,814
LocationSan Francisco, US + Dublin, IE

Real result.

Works in Claude Code, Cursor, Codex, VS Code and any MCP agent.

What your agent can pull from X (Twitter)

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

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.

terminal
npx agentcash add https://tollnode.com

Copy for your AI agent

Paste this into your agent so it knows what this node does and how to call it.

prompt
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

request body: search
{"action":"search","query":"x402 payments"}
request body: posts
{"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

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.

Ready in a minute

Connect your AI
For developers: endpoint, inputs and an example response

POST https://tollnode.com/api/v1/nodes/x-twitter

Input

FieldTypeNotes
querystringSearch query; X search operators work, e.g. x402 payments, #bitcoin, from:nasa (for: search)
action*enumWhat to do; sets the price. search (needs query), posts (needs handle), profile (needs handle). Default search (search, posts, profile)
handlestringAccount handle without @, e.g. NatGeo (for: posts, profile)
sortByenumOptional, 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.