Wire TwitterAPIs into Claude, Cursor, and Windsurf

{
  "mcpServers": {
    "twitterapis": {
      "command": "npx",
      "args": ["-y", "@twitterapis/mcp"],
      "env": {
        "TWITTERAPIS_KEY": "your_api_key_here"
      }
    }
  }
}

claude mcp add twitterapis -- npx -y @twitterapis/mcp

export TWITTERAPIS_KEY="your_api_key_here"

{
  "mcpServers": {
    "twitterapis": {
      "command": "npx",
      "args": ["-y", "@twitterapis/mcp"],
      "env": {
        "TWITTERAPIS_KEY": "your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "twitterapis": {
      "command": "npx",
      "args": ["-y", "@twitterapis/mcp"],
      "env": {
        "TWITTERAPIS_KEY": "your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "twitterapis": {
      "command": "npx",
      "args": ["-y", "@twitterapis/mcp"],
      "env": {
        "TWITTERAPIS_KEY": "your_api_key_here"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "twitterapis": {
        "command": "npx",
        "args": ["-y", "@twitterapis/mcp"],
        "env": {
          "TWITTERAPIS_KEY": "your_api_key_here"
        }
      }
    }
  }
}

curl "https://api.twitterapis.com/twitter/tweet/advanced_search?query=stripe+api+min_faves%3A10&product=Latest" \
  -H "Authorization: Bearer $TWITTERAPIS_KEY"

import os
import requests

API_KEY = os.environ["TWITTERAPIS_KEY"]
BASE_URL = "https://api.twitterapis.com/twitter"

def search_tweets(query: str, max_pages: int = 3) -> list:
    """Search tweets with automatic pagination up to max_pages."""
    session = requests.Session()
    session.headers.update({"Authorization": f"Bearer {API_KEY}"})

    tweets = []
    cursor = None
    page = 0

    while page < max_pages:
        params = {"query": query, "product": "Latest"}
        if cursor:
            params["cursor"] = cursor

        resp = session.get(
            f"{BASE_URL}/tweet/advanced_search",
            params=params,
            timeout=15,
        )

        if resp.status_code == 429:
            raise RuntimeError("Rate limited. Back off and retry.")
        if resp.status_code == 402:
            raise RuntimeError("Credit balance exhausted. Top up at twitterapis.com.")
        resp.raise_for_status()

        data = resp.json()
        tweets.extend(data.get("tweets", []))
        page += 1

        if not data.get("next_cursor") or not data.get("tweets"):
            break
        cursor = data.get("next_cursor")

    # Cost note: page * $0.0008 per call
    print(f"Fetched {len(tweets)} tweets in {page} page(s). Cost: ${page * 0.0008:.4f}")
    return tweets


if __name__ == "__main__":
    results = search_tweets('"stripe api" min_faves:10 -is:retweet lang:en')
    for t in results[:5]:
        print(f"@{t['author']['username']}: {t['text'][:100]}")

// search.ts
// Run: TWITTERAPIS_KEY=your_key npx tsx search.ts

const API_KEY = process.env.TWITTERAPIS_KEY;
if (!API_KEY) throw new Error("Set TWITTERAPIS_KEY.");

const BASE_URL = "https://api.twitterapis.com/twitter";

interface Tweet {
  id: string;
  text: string;
  author: { username: string; name: string };
  favorite_count?: number;
}

interface SearchResponse {
  tweets: Tweet[];
  next_cursor: string;
}

async function searchTweets(query: string, maxPages = 3): Promise<Tweet[]> {
  const tweets: Tweet[] = [];
  let cursor: string | null = null;
  let page = 0;

  while (page < maxPages) {
    const url = new URL(`${BASE_URL}/tweet/advanced_search`);
    url.searchParams.set("query", query);
    url.searchParams.set("product", "Latest");
    if (cursor) url.searchParams.set("cursor", cursor);

    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${API_KEY}` },
    });

    if (res.status === 429) throw new Error("Rate limited. Back off and retry.");
    if (res.status === 402) throw new Error("Credit exhausted. Top up at twitterapis.com.");
    if (!res.ok) throw new Error(`Request failed: ${res.status} ${await res.text()}`);

    const data: SearchResponse = await res.json();
    tweets.push(...(data.tweets ?? []));
    page++;

    if (!data.next_cursor || data.tweets.length === 0) break;
    cursor = data.next_cursor;
  }

  // Cost note: page * $0.0008 per call
  console.log(`Fetched ${tweets.length} tweets in ${page} page(s). Cost: $${(page * 0.0008).toFixed(4)}`);
  return tweets;
}

// Example
const results = await searchTweets('"stripe api" min_faves:10 -is:retweet lang:en');
for (const t of results.slice(0, 5)) {
  console.log(`@${t.author.username}: ${t.text.slice(0, 100)}`);
}