# io.github.pedrot95dev/twitterapi (npm · @pedrot95dev/twitterapi.mcp)

Read/write X (Twitter) via twitterapi.io: mentions, thread context, create and delete tweets.

- Trust score: 78/100 (medium)
- Change this week: +52
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@pedrot95dev/twitterapi.mcp`: 78/100 (this document), [markdown](https://verifymcp.io/servers/pedrot95dev-twitterapi/pedrot95dev-twitterapi-mcp.md), [page](https://verifymcp.io/servers/pedrot95dev-twitterapi/pedrot95dev-twitterapi-mcp)

## Channel facts

- Registry: `npm`
- Package: `@pedrot95dev/twitterapi.mcp`
- Version: `0.1.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (96 of 100), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to pedrot95dev/twitterapi.mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 30 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 552 tokens (~138/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add pedrot95dev-twitterapi -- npx -y @pedrot95dev/twitterapi.mcp
```

### Codex

```bash
codex mcp add pedrot95dev-twitterapi -- npx -y @pedrot95dev/twitterapi.mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pedrot95dev-twitterapi": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@pedrot95dev/twitterapi.mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add pedrot95dev-twitterapi --command npx --arg -y --arg @pedrot95dev/twitterapi.mcp
```

### Hermes

```yaml
mcp_servers:
  pedrot95dev-twitterapi:
    command: "npx"
    args: ["-y", "@pedrot95dev/twitterapi.mcp"]
```

### Other

```json
{
  "mcpServers": {
    "pedrot95dev-twitterapi": {
      "command": "npx",
      "args": [
        "-y",
        "@pedrot95dev/twitterapi.mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 78, +4)

- [functional improvement] Stability: unverified → 0.23

### 2026-08-02 (score 74, +69)

- [security improvement] Provenance: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [security] The attested source repository moved: pedrot95dev/twitterapi.mcp
- [functional regression] Security disclosure: fail → unverified
- [functional improvement] Schema quality: unverified → good
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Maintenance: unverified → pass
- [functional] Licence: MIT

### 2026-08-01 (score 5, −20)

- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: pass → unverified

### 2026-07-31 (score 25, −21)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 46, +20)

- [functional regression] Dependency health: partial → unverified
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: unverified
- [functional] First check of Schema quality: fail

### 2026-07-27 (score 26)

First indexed and scored.

## MCP tools (4)

### `get_user_mentions` (~143 tokens)

Get user mentions

Fetch tweets mentioning a specific X/Twitter user. Makes a single request per call. The caller handles pagination by passing `cursor` (from a previous `next_cursor`).

Input parameters:

- `cursor` (string): Pagination cursor from a previous response's next_cursor
- `limit` (integer): Max tweets to return from this single request (default 50)
- `query_type` (string): Sort mode (default Latest)
- `since_time` (string): Start time filter (e.g. 2025-06-01 or ISO datetime)
- `until_time` (string): End time filter
- `user_name` (string, required): X username, with or without @

### `get_tweet_thread_context` (~134 tokens)

Get tweet thread context

Fetch one page of the conversation thread around a tweet (to find links in context). Returns the original tweet, intermediate replies up the chain, the tweet itself, and its direct replies; each tweet includes `entities.urls` with expanded links. Makes exactly one request per call: pages are uneven (a page may be empty while `has_next_page` is true), so pass `next_cursor` back as `cursor` to fetch the next page.

Input parameters:

- `cursor` (string): Pagination cursor from a previous response's next_cursor
- `tweet_id` (string, required): The tweet ID to get the thread context for

### `create_tweet` (~213 tokens)

Create tweet

Create or reply to a tweet via the v2 endpoint. Uses `login_cookies` built from the account's `auth_token`/`ct0` env vars (requires TWITTERAPI_IO_AUTH_TOKEN, TWITTERAPI_IO_CT0, TWITTERAPI_IO_PROXY).

Input parameters:

- `attachment_url` (string): URL for quote (alternative to quote_tweet_id)
- `community_id` (string): Post inside a specific community
- `is_note_tweet` (boolean): Allow >280 chars (Premium accounts)
- `media_ids` (array): Media IDs from prior /twitter/upload_media_v2
- `quote_tweet_id` (string): Tweet ID to quote
- `reply_to_tweet_id` (string): Tweet ID to reply to (makes this a reply)
- `schedule_for` (string): ISO-8601 future time e.g. 2026-01-20T10:00:00.000Z
- `tweet_text` (string, required): The text content of the tweet

### `delete_tweet` (~62 tokens)

Delete tweet

Delete a tweet by ID (must be owned by the logged-in account). Uses `login_cookies` built from the account's `auth_token`/`ct0` env vars.

Input parameters:

- `tweet_id` (string, required): The ID of the tweet to delete

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/pedrot95dev-twitterapi/pedrot95dev-twitterapi-mcp#diagnostics

## Score history

- 2026-08-03: 78
- 2026-08-02: 74
- 2026-08-01: 5
- 2026-07-31: 25
- 2026-07-30: 46
- 2026-07-28: 46
- 2026-07-27: 26

## Links

- npm package: https://www.npmjs.com/package/@pedrot95dev/twitterapi.mcp
- Socket report: https://socket.dev/npm/package/@pedrot95dev/twitterapi.mcp
- Repository: https://github.com/pedrot95dev/twitterapi.mcp
- Changelog RSS feed: https://verifymcp.io/servers/pedrot95dev-twitterapi/pedrot95dev-twitterapi-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/pedrot95dev-twitterapi/pedrot95dev-twitterapi-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/pedrot95dev-twitterapi/pedrot95dev-twitterapi-mcp