# TwtAPI

**Category:** 🌐 Social Media  
**Repository:** https://github.com/TonyGJJ/twtapi-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/twtapi

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "twtapi": {
    "command": "npx",
    "args": ["-y","twtapi"]
  }
}
```

## Documentation & 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

1. Create a free TwtAPI account at [twtapi.com](https://www.twtapi.com/en/login?mode=register).
2. Open the MCP page in the dashboard and generate an `sk-` MCP key.
3. Pick a client configuration below and replace `sk-your-mcp-key`.

The recommended transport is Streamable HTTP:

```text
https://mcp.twtapi.com/mcp
```

Send the MCP key as a bearer token:

```text
Authorization: Bearer sk-your-mcp-key
```

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

```text
https://mcp.twtapi.com/sse?mcp_key=sk-your-mcp-key
```

## Client setup

| Client | Setup |
| --- | --- |
| Cursor | [`examples/cursor.json`](https://github.com/TonyGJJ/twtapi-mcp/blob/HEAD/examples/cursor.json) |
| Claude Code | [`examples/claude-code.md`](https://github.com/TonyGJJ/twtapi-mcp/blob/HEAD/examples/claude-code.md) |
| Codex CLI | [`examples/codex-cli.md`](https://github.com/TonyGJJ/twtapi-mcp/blob/HEAD/examples/codex-cli.md) |
| Grok | [`examples/grok.md`](https://github.com/TonyGJJ/twtapi-mcp/blob/HEAD/examples/grok.md) |

## Available tools

The hosted server currently exposes 10 tools for search, user lookup, timelines, followers, tweet detail, and trends. See [`docs/tools.md`](https://github.com/TonyGJJ/twtapi-mcp/blob/HEAD/docs/tools.md) for parameters and example prompts.

## Documentation

- [Authentication](https://github.com/TonyGJJ/twtapi-mcp/blob/HEAD/docs/authentication.md)
- [Tool reference](https://github.com/TonyGJJ/twtapi-mcp/blob/HEAD/docs/tools.md)
- [Troubleshooting](https://github.com/TonyGJJ/twtapi-mcp/blob/HEAD/docs/troubleshooting.md)
- [TwtAPI MCP setup page](https://www.twtapi.com/en/mcp/)
- [TwtAPI API documentation](https://www.twtapi.com/en/docs/)
- [Pricing](https://www.twtapi.com/en/pricing/)

## Health check

```bash
curl https://mcp.twtapi.com/health
```

Expected response:

```json
{"status":"ok","service":"twtapi-mcp"}
```

## 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.