Social Media

twitr.sh

Fetches data from X (Twitter) including tweets, user profiles, timelines, lists, and communities.

x402 supported1 endpoint14 known toolsFirst detected July 28, 2026Last detected July 29, 2026

ENDPOINT 1

https://twitr.sh/api/mcp

No auth detected

MCP server metadata

Name: twitr.sh
Version: 1.0.0

Capabilities

toolsexperimental.payment.protocolVersionsexperimental.payment.methods.tempo.intentsexperimental.payment.methods.x402.intents

Server instructions

twitr.sh is a pay-per-call X/Twitter API: reads, search, timelines, bulk extractions, real-time monitors with webhook delivery, and posting through a connected X account. Calls without a payment credential return error -32042 with USDC terms for x402 (Base/Solana) and MPP (Tempo); pass the credential in params._meta['org.paymentauth/credential']. Volume tools require resultsLimit (1-10000) and bill per returned item. Resource-creating tools (extractions, monitors, draws, writes) require an idempotency key in params._meta['org.paymentauth/idempotencyKey'] — retries replay instead of re-charging. Monitors are prepaid by the hour and need a recoverable wallet (Base or Tempo, not Solana). Writes act only through X accounts the paying wallet has connected via POST /api/x-accounts/connect. Full playbook: https://twitr.sh/skill.md — agent guide: https://twitr.sh/llms.txt

Known tools 14

x_read

Read live X/Twitter data: look up a single tweet or user profile, batch-read up to 100 tweets or users at once, check whether one account follows another, fetch trending topics by region, extract a long-form article, or download tweet media.

Inferred read-only

x_search

Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword.

Inferred read-only

x_timeline

Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited).

Inferred read-only

x_lists

Read an X/Twitter List: its combined tweet timeline, its member roster, or its followers.

Inferred read-only

x_communities

Read an X/Twitter Community: profile info, member and moderator rosters, the community's tweets, or keyword search inside the community.

Inferred read-only

x_extract

Bulk-export X/Twitter data as downloadable datasets: followers, following, repliers, quoters, reposters, likers, mentions, full threads, list and community members, spaces, or people/tweet search results — 23 extractors.

Inferred read-only

x_monitor

Watch an X/Twitter account or keyword query in real time: new tweets, replies, quotes, mentions, hashtags, and profile changes, delivered to your agent by free polling or HMAC-signed webhooks.

Inferred read-only

x_draws

Run a provably fair giveaway on X/Twitter: pick crypto-random winners from a tweet's replies, with retweet, follow, hashtag, keyword, minimum-follower, and account-age conditions.

Inferred read-only

x_write

Act on X/Twitter through an account you connect: post a tweet, reply, like, retweet, follow or unfollow, send a DM, delete a tweet, remove a follower, or upload media.

Potential side effects

x_inbox

Read a connected X/Twitter account's private surfaces: bookmarks and bookmark folders, notifications, and DM history.

Inferred read-only

x_profile

Edit a connected X/Twitter account's profile: display name, bio, location, website link, avatar image, and banner image.

Potential side effects

x_community

Manage X/Twitter Communities as a connected account: create a new community, join or leave an existing one, or delete a community you own.

Potential side effects

x_radar

Trending topics and breaking stories across tech, dev, science, business, culture, politics, and entertainment — aggregated from multiple public sources with regional and time-window filters.

Inferred read-only

x_compose

Draft tweets with AI: generate variants from a topic and goal, refine an existing draft, or score a draft for likely engagement — with tone, call-to-action, and style-matching options.

Inferred read-only

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.twitr-sh]
url = "https://twitr.sh/api/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "twitr-sh": {
      "type": "http",
      "url": "https://twitr.sh/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: twitr-sh
Remote MCP URL: https://twitr.sh/api/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "twitr-sh": {
      "url": "https://twitr.sh/api/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "twitr-sh": {
      "type": "http",
      "url": "https://twitr.sh/api/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "twitr-sh",
  "transport": "streamable-http",
  "url": "https://twitr.sh/api/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

TRUST AND VERIFICATION EVIDENCE

Trust Data Available

BuiltWith Trust API v2 evidence for twitr.sh was fetched 2026-07-31T04:00:37.575Z.

Trust status Neutral

twitr.sh is assessed as Neutral: No suspicious signals found, but no strong positive signal either

Indexed

Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.