TwtAPI

io.github.TonyGJJPublished by GitHub account TonyGJJv1.0.0Updated Nov 2, 2026

Hosted Twitter/X tools for search, users, timelines, followers, trends, and research.

VerifiedStreamable HTTPWeb executableWeb Search & Scraping Data & Analytics

Server details

Identifier: io.github.TonyGJJ/twtapi
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account TonyGJJ for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.TonyGJJ%2Ftwtapi.svg)](https://sourceweft.com/mcp/io.github.TonyGJJ%2Ftwtapi?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted TwtAPI MCP server that gives assistants tools to search and research public Twitter/X data: tweets, users, timelines, followers and trends.

What you can do: Search Twitter/X content and look up tweet details
Look up user profiles, their timelines and follower lists
Retrieve trending topics and research-oriented results
Connect from MCP clients such as Cursor, Claude Code, Codex CLI or Grok over a hosted endpoint
When to use it: Useful when an assistant needs public Twitter/X data for research, monitoring topics or accounts, or gathering social context without building your own scraping or API integration.
Requirements: A remote hosted endpoint (Streamable HTTP, with SSE also offered); no local runtime. A free TwtAPI account and an sk- MCP key sent as an Authorization bearer token. Network access to the TwtAPI service.

Before you install

The MCP key is a secret: do not commit it to repositories, prefer environment variables or the client's secret storage, and regenerate it if exposed. The SSE option passes the key in the URL query string, which is easier to leak. Requests go to a third-party hosted service, and pricing applies per the provider's plans.

Installation

In SourceWeft

Open TwtAPI in the dashboard and add it to a workspace.
Connect Authorization token credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.TonyGJJ%2Ftwtapi/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "twtapi": {
      "type": "http",
      "url": "https://mcp.twtapi.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

TwtAPI MCP Server

Use public Twitter/X data from Cursor, Claude Code, Codex CLI, Grok, or any compatible MCP client. TwtAPI hosts the server, so there is no local runtime to install or maintain.

Quick start

Create a free TwtAPI account at twtapi.com.
Open the MCP page in the dashboard and generate an sk- MCP key.
Pick a client configuration below and replace sk-your-mcp-key.

The recommended transport is Streamable HTTP:

Send the MCP key as a bearer token:

SSE remains available for clients that do not yet support Streamable HTTP:

Client setup

Available tools

The hosted server currently exposes 10 tools for search, user lookup, timelines, followers, tweet detail, and trends. See docs/tools.md for parameters and example prompts.

Documentation

Health check

Expected response:

Security

Do not commit MCP keys to a repository. Prefer environment variables or your client's secret storage. Regenerate the key from the TwtAPI dashboard if it is exposed.

This repository contains public configuration and documentation for the hosted service. The production server implementation is maintained separately.

Source: README.md at commit b4590f5

Tools

This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

v1.0.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.