# MCP Server

> MCP Server is a paid MCP server for web search and scraping. Hosted twitterapi.io server for X posts, profiles, followers and trends, paid per result. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://twitterapi.io
- **MCP Registry name:** io.twitterapi/mcp-server
- **Categories:** web search and scraping, analytics and data
- **Listing updated:** 2026-11-14

## About

This is the official hosted connector for twitterapi.io, a pay-as-you-go data API for public X data. Behind it sit 75 documented endpoints, including advanced tweet search with date windows, user timelines and mentions, profiles (single or batched), follower and following graphs, reply and quote trees, retweeters, lists, communities, regional trends, and real-time delivery by webhook filter rules or WebSocket.

Charges follow results returned rather than a monthly plan. The pricing page quotes 15 credits ($0.00015) as the minimum per call, 15 credits per tweet returned, and volume discounts for batch profiles and follower pages, with $1 equal to 100,000 credits. New accounts can claim up to $1 of free credits, which expire after 31 days.

The MCP endpoint accepts OAuth or an API key. The site's cost, rate-limit and latency comparisons with the official API are the vendor's own claims.

## Features

- **Tweet search:** Advanced filters, date windows and bulk sub-queries.
- **Timelines and profiles:** Latest tweets, mentions and user info, batched by IDs.
- **Follower graph:** Followers, followings and follower IDs with page-size pricing.
- **Trends and lists:** Regional trends and list members or tweets.
- **Communities:** Community tweets, members and moderators.
- **Real-time delivery:** Webhook rules and WebSocket streams.

## Good for

- Have an assistant search recent posts on a topic
- Pull a user's followers for audience analysis
- Monitor mentions for a bot
- Check what is trending in a region

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://mcp.twitterapi.io/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.twitterapi.io/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.twitterapi.io/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.twitterapi.io/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.twitterapi.io/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.twitterapi.io/v1/mcp"
    }
  }
}
```

## Tools

- `search_tweets`: 🎯 PRIMARY CHOICE for date-range / historical / keyword-based tweet queries. Use this (NOT get_user_last_tweets) whenever user asks about a SPECIFIC TIME RANGE or historical tweets: • 'tweets from January 2026' → query='from:elonmusk since:2026-01-01 until:2026-02-01' • 'tweets between X and Y' → 'from:USER since:X until:Y' • 'tweets last week / last month' → translate to since:/until: dates • 'tw
- `get_user_info`: Fetch basic profile info for a Twitter/X user by their screen name (handle). Returns user ID, display name, bio, follower/following counts, verified status, profile picture, banner, location, website, and account creation date. Use this as the starting point for any user analysis.
- `get_user_about`: Fetch the extended 'about' / profile page data for a Twitter/X user by screen name. Returns extra profile metadata beyond what get_user_info gives (when available). Use get_user_info first; only call this if you need additional about-page fields.
- `get_user_followers`: Fetch followers of a Twitter/X user in reverse chronological order (newest first), each with full profile metadata (name, bio, follower count, verified status, etc.). Paginates via cursor. Use this to analyze who follows an account, build follower audiences, or sample for competitive analysis. For large accounts use pagination; you will not get all followers in one call.
- `get_user_followings`: Fetch the accounts a Twitter/X user follows, with full profile metadata. Paginates via cursor. Use this to map a user's interest graph (who they follow signals what they care about).
- `get_user_last_tweets`: ⚠️ ONLY for 'latest / recent / what's new' queries about a user. DO NOT use for date-range queries (e.g. 'tweets from January 2026', 'tweets last week', 'tweets between X and Y', 'tweets in 2025'). For specific dates / older tweets, use **search_tweets** with query like 'from:elonmusk since:2026-01-01 until:2026-02-01'. Fetch the MOST RECENT tweets posted by a Twitter/X user, sorted by created_at 
- `get_user_mentions`: Fetch tweets that mention a specific Twitter/X user (i.e. tweets containing @userName). Useful for brand monitoring, sentiment tracking on a public figure, or finding conversations involving an account. Supports time-bound queries via sinceTime/untilTime (Unix seconds). Paginates via cursor.
- `get_tweets_by_ids`: Batch-fetch full tweet objects by their numeric tweet IDs. Pass a comma-separated string of up to 50 IDs. Use this when you already have specific tweet IDs (e.g., from a search result, a URL, or a webhook event) and need the full tweet data — author, text, engagement counts, media, etc.
- `get_tweet_replies`: Fetch replies to a specific tweet. Pass the numeric tweetId of the root tweet; returns top-level replies (about 20 per page) with full tweet objects. Use this for thread analysis, sentiment on a viral post, or building reply trees.
- `get_tweet_quotes`: Fetch quote-tweets (tweets that quote the given tweetId). Useful for finding commentary on a tweet, measuring reach beyond direct replies. Supports time bounds (sinceTime/untilTime, Unix seconds). Paginates via cursor (~20 per page).
- `get_tweet_retweeters`: Fetch users who retweeted a specific tweet (the simple 'retweet' action, not quote-tweets — for those use get_tweet_quotes). Returns user profiles with metadata. Paginates via cursor (~20 per page).
- `get_trends`: Fetch current trending topics/hashtags for a location. Pass a Yahoo Where-On-Earth ID (woeid). Common: 1=Worldwide, 23424977=USA, 23424975=UK, 23424856=Japan, 23424848=India, 23424881=South Korea. Use woeid=1 for global trends if you don't know a specific location.

## FAQ

### How is it billed?

Per result returned, with a minimum of $0.00015 per request and credits that never expire once recharged.

### Is there a free allowance?

Up to $1 in sign-up credits, no card, expiring after 31 days.

### How do I authenticate?

OAuth or an API key.

### Does it cover private accounts?

The service describes itself as an API for public social data.

### Is MCP Server free?

No. MCP Server is a paid product.

### How do I add MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.twitterapi.io/v1/mcp

### What are the best alternatives to MCP Server?

The closest alternatives to MCP Server are Scrapling MCP Server, Firecrawl MCP Server, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP and SearXNG Search.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/mcp-server-mwep7pih
