X (Twitter) Real-Time MCP Server — Search, Threads, Profiles & Trends
Built with the partner engineering ecosystem behind TwitterAPI.io. Access 16 high-speed, enterprise-grade X endpoints ($0.002/call, zero monthly enterprise minimums) over Streamable HTTP MCP, Bearer API key, Base/Solana x402, or Tempo MPP.
claude mcp add --transport http agentapigate-x-twitter "https://mcp.agentapigate.ai/mcp/x" \ --header "Authorization: Bearer aag_live_YOUR_KEY"
# 1. Inspect deterministic 402 quote (Base USDC + Solana USDC + Tempo MPP): curl -i "https://api.agentapigate.ai/v1/x/tweet/search?query=Model+Context+Protocol+min_faves%3A10&queryType=Latest&format=compact" # 2. Or execute immediately with an aag_live_* / scoped aag_agent_* key: curl -s "https://api.agentapigate.ai/v1/x/tweet/search?query=Model+Context+Protocol+min_faves%3A10&queryType=Latest&format=compact" \ -H "Authorization: Bearer $AAG_API_KEY" \ -H "X-AAG-Max-Cost: 0.0100"
{
"ok": true,
"meta": {
"endpoint": "x.tweet.search",
"format": "compact",
"cost_usd": 0.002,
"tokens_est": 3461,
"raw_tokens_est": 37993,
"tokens_saved_pct": 93,
"latency_ms": 1712,
"content_trust": "external_untrusted"
},
"data": {
"query": "Model Context Protocol min_faves:10",
"count": 20,
"items": [
{
"id": "2123646487301099608",
"author": {
"handle": "OnlyHommie"
},
"text": "What are Motes NFTs?\n\nInstead of functioning as passive digital collectibles or profile pictures, Motes NFTs represent functional, autonomous financial AI agents. Built on the Ethereum-compatible Layer 2 Robinhood Chain, the project operates on a straightforward premise: One NFT = One AI Agent.\n\nThe Architecture: Every @meetmotes in the fixed 20,000 Genesis collection is linked to its own dedicated smart account. The NFT serves as the agent's identity and proof of ownership, the smart account holds the capital (such as USDC), and the AI intelligence layer analyzes market conditions to coordina…",
"metrics": {
"likes": 77,
"views": 421
},
"created_at": "Fri Nov 20 05:15:52 +0000 2026",
"url": "https://x.com/OnlyHommie/status/2123646487301099608"
},
{
"id": "2123632214948856135",
"author": {
"handle": "bitshala_org"
},
"text": "BOSS Summit Winter 2026: A Week at the Frontier of Bitcoin Open-Source Development\n\nJaipur, India | October 26–31, 2026 https://t.co/iy2AHqnYOJ",
"metrics": {
"likes": 25,
"views": 786
},
"created_at": "Fri Nov 20 04:19:09 +0000 2026",
"url": "https://x.com/bitshala_org/status/2123632214948856135"
},
{
"id": "2123604032401150357",
"author": {
"handle": "yulmu_coffee"
},
"text": "아래 내용을 복사한 뒤, 에이전트에게 이렇게 메시지를 보내세요.\n\n\"클립보드에 저장된 원칙을 md로 저장하고, 이를 기반으로 전체 코드 중 원칙 위반을 찾고, 퀄리티를 높여.\"\n\n--- 클립보드에 복사해 넣어두실 것 ---\n\n# Your role\n\nYou are a senior engineer working in this repository. You value \"evidence that it actually works\" and \"a codebase the next person can read easily\" over how fast you write code. I supervise asynchronously. Make your own calls on anything reversible and come back with results and evidence.\n\n# Core principles\n\n- Verification is all you need. Run every change you make and confirm it yourself. \"It compiles,\" \"the tests are green,\" and \"it should work\" are not ev…",
"metrics": {
"likes": 24,
"views": 1262
},
"created_at": "Fri Nov 20 02:27:10 +0000 2026",
"url": "https://x.com/yulmu_coffee/status/2123604032401150357"
},
{
"id": "2123589646118707653",
"author": {
"handle": "iansh04_"
},
"text": "Don't watch Netflix tonight. Spend 2 hours checking out this complete Stanford AI course that teaches you how to build and automate anything with AI. Anyone who watches this tonight will wake up tomorrow with a new skill under their belt. Watch now, save for later.\n\n🚨BREAKING: Anthropic just dropped free courses to master AI with certificates.\n\nNo tuition. No waitlist. No BS.\n\nHere're 10 courses that will replace a $50K degree👇\n\n1. Anthropic: AI Fundamentals with Claude\nhttps://t.co/l0HWauKuBs\n\nhttps://t.co/ZRNnvLAJxh\n\n2. Anthropic: AI Automation with Claude\nhttps://t.co/ZRNnvLAJxh\n\n3. A…",
"metrics": {
"likes": 27,
"views": 872
},
"creaWhy Engineers Mount This Connector via AgentAPIGate
- 01 · GUARANTEE
Sub-second median latency across advanced search operators (from:, min_faves:, since:, filter:links), conversation threads, quote tweets, communities, and lists.
- 02 · GUARANTEE
Pay strictly $0.0020 per successful call from your non-expiring paid_usd balance or settle keyless per call via Base USDC / Solana USDC x402 or Tempo MPP.
- 03 · GUARANTEE
Compact output (?format=compact|md) strips deeply nested user/media entities so 20 tweets fit cleanly in ~650 LLM tokens instead of 5,000+ raw JSON tokens.
Included MCP Tools & Deterministic Per-Call Pricing
Browse all 74 endpoints →| MCP Tool / Endpoint ID | Summary | API Key Price | x402 / MPP | p50 Latency | Bonus Credit |
|---|---|---|---|---|---|
| x_search_tweets x.tweet.search | Search real-time or historical X (Twitter) posts with full search operators (Latest or Top). | $0.0020 | $0.0020 | 1712 ms | paid_usd / x402 |
| x_get_tweet_thread x.tweet.thread | Reconstruct the full parent/author conversation thread surrounding a tweet ID. | $0.0020 | $0.0020 | 1474 ms | paid_usd / x402 |
| x_get_tweets x.tweet.detail | Fetch full normalized post text, author metadata, and engagement metrics for one or more tweet IDs. | $0.0020 | $0.0020 | 1724 ms | paid_usd / x402 |
| x_get_user_info x.user.info | Fetch complete profile metadata, bio, follower count, and verification badge by X handle. | $0.0020 | $0.0020 | 155 ms | paid_usd / x402 |
| x_get_user_tweets x.user.tweets | Fetch the latest timeline posts authored by an X handle. | $0.0020 | $0.0020 | 1324 ms | paid_usd / x402 |
| x_get_trends x.trends.place | Fetch live trending topics and tweet volumes on X by geographic WOEID (1 = Worldwide, 23424977 = US). | $0.0020 | $0.0020 | 422 ms | paid_usd / x402 |
Frequently Asked Questions
Do I need X Enterprise / Basic developer portal tiers to use ai.agentapigate/x-twitter-mcp?
No. There is $0/month subscription lock-in. Deposit $10+ paid_usd (which never expires) or pay $0.002/call directly on-chain via Coinbase x402 (Base & Solana USDC) or Stripe+Tempo MPP.
Can partner bonus_usd credits be used on the X (Twitter) pack?
Partner bonus_usd credits cover our 7 non-X data packs (Search, Social, Commerce, B2B, Finance, Local, Intel). All x.* endpoints run on paid_usd or keyless x402 / MPP micropayments.