superagnt_
// data source

X (Twitter) data for AI agents

Posts, profiles, followers, replies, search, lists and trends, as structured JSON. One key, and no separate X developer plan.

opt in // data:xover mcp or http

Copy the setup prompt.
Your agent does the rest.

works with any agent+ 8 more
Fetch and execute the appropriate instructions to set me up for superagnt_ from https://mcp.superagnt.com/agent-setup/prompt.md
or follow the detailed setup instructions

» once it is connected, run this so your agent can switch the source on itself.

agnt_tools_enable({ families: ['data:x'] })
01// what is inside

Everything your agent can pull

Post search

Full search by query, language and date range, with floors on likes, replies and reposts, and continuation paging.

User timeline

A user posts with or without replies, plus their media and likes, all continuable.

Profiles

User details and about data, by username or by user id.

Social graph

Followers and following, paged, for mapping who an account is connected to.

Post detail and reactions

A single post with its replies, plus who liked it and who reposted it.

Hashtags and lists

Posts under a hashtag and the timeline of a list, both with continuation.

Trends and geo

Trends near a location, the locations trends are available for, and geo search.

Text analysis

Sentiment, topic classification, named entity recognition and translation over the text you pulled.

tool names08as your agent sees them
data_x_search_get_search_searchdata_x_user_s_tweets_get_user_tweetsdata_x_user_details_get_user_detailsdata_x_user_s_followers_get_user_followersdata_x_tweet_details_get_tweet_detailsdata_x_tweet_replies_get_tweet_repliesdata_x_hashtag_get_hashtag_hashtagdata_x_get_trends_near_a_location_beta_get_trends
02// what it gets used for

Three jobs it can start on today

01

Lead signal from public posts

The agent searches for people describing the problem you solve, filters by an engagement floor, resolves each author profile, and writes qualified accounts with the post that triggered them.

02

Mention triage

A schedule searches your brand and product terms, pulls the replies under anything above a threshold, and asks a human only where a response is actually warranted.

03

Competitive narrative tracking

The agent walks competitor timelines and the replies underneath, runs sentiment over the text, and reports what people push back on.

03// one call

What comes back

Your agent reads this response directly, with no parsing layer of your own in between. The same JSON comes back over plain HTTP, so a cron job or a script sees exactly what the agent sees.

https://mcp.superagnt.com/mcptool call
→ calldata_x_search_get_search_search
{
  "query": "\"crm migration\" -filter:replies",
  "limit": 20,
  "min_likes": 5
}
← resultjson
{
  "results": [
    {
      "tweet_id": "1900000000000000001",
      "creation_date": "Fri Jul 10 14:22:05 +0000 2026",
      "text": "Three weeks into a crm migration and the field mapping is the whole job.",
      "favorite_count": 41,
      "reply_count": 9,
      "user": { "username": "ops_builder_dev", "follower_count": 5820 }
    },
    { "...": "19 more results" }
  ],
  "continuation_token": "DAADDAABCgABF..."
}
» trimmed for length. the shape is the shape your agent receives.
04// cost

What it costs to run

per call
priced per call

Calls in X (Twitter) are priced individually and deducted from your credit balance, and only a successful call is billed. The per-endpoint figures live in the reference docs, and every billable response reports its own cost in meta.costCents.

One balance covers this source and every other one, so there is no per-source subscription and no upstream account of your own to keep alive.

how credits work →
05// questions

Before you wire it up

01Do I need an X developer plan?

No. There is no separate developer subscription, no project to create and no bearer token to rotate. One key and one credit balance cover it.

02How does my agent get these tools?

Connect to https://mcp.superagnt.com/mcp and call agnt_tools_enable with data:x.

03How do I page past the first batch?

Search and timeline calls return a continuation token. Pass it to the matching continuation tool and repeat until no token comes back.

04How is usage billed?

Calls consume platform credits based on provider and endpoint. See credit costs in the dashboard and on each endpoint page.

05What about rate limits?

Rate limits depend on your plan. The API returns standard HTTP status codes; retry with backoff on 429 responses.

get your key

Point your client at https://mcp.superagnt.com/mcp and your agent has this, plus everything else on one balance.

Start free
06// keep going

The rest of what your agent can reach