# io.github.dorukardahan/twitterapi-io-mcp (npm · twitterapi-io-mcp)

Offline access to TwitterAPI.io docs for AI assistants. 67 endpoints, 32 pages, 24 blog posts.

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

## Components

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

## Channel facts

- Registry: `npm`
- Package: `twitterapi-io-mcp`
- Version: `1.5.10`
- 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**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), 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 (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 97 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1028 tokens (~44/item across 23 items; 7 tools + 16 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **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.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add dorukardahan-twitterapi-io-mcp -- npx -y twitterapi-io-mcp
```

### Codex

```bash
codex mcp add dorukardahan-twitterapi-io-mcp -- npx -y twitterapi-io-mcp
```

### opencode

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

### OpenClaw

```bash
openclaw mcp add dorukardahan-twitterapi-io-mcp --command npx --arg -y --arg twitterapi-io-mcp
```

### Hermes

```yaml
mcp_servers:
  dorukardahan-twitterapi-io-mcp:
    command: "npx"
    args: ["-y", "twitterapi-io-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "dorukardahan-twitterapi-io-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "twitterapi-io-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-02 (score 67, +41)

- [security regression] Provenance: unverified → fail
- [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).
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional] Licence: MIT

### 2026-07-31 (score 26, −9)

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

### 2026-07-30 (score 35, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-28 (score 53, +29)

- [functional regression] Security disclosure: unverified → fail
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: unverified
- [functional] First check of Schema quality: pass
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100

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

First indexed and scored.

## MCP tools (7)

### `search_twitterapi_docs` (~200 tokens)

Search TwitterAPI.io documentation: API endpoints, guides (pricing, rate limits, filter rules), and blog posts.

USE THIS WHEN: You need to find information across the entire documentation.
RETURNS: Ranked results with endpoint paths, descriptions, and relevance scores.

Examples:
\- "advanced search" → finds tweet search endpoints
\- "rate limit" → finds QPS limits and pricing info
\- "webhook" → finds webhook setup endpoints
\- "getUserInfo" → finds user info endpoints (supports camelCase)

Input parameters:

- `max_results` (integer): Number of results to return. Use higher values (15-20) for comprehensive research, lower values (3-5) for quick lookups.
- `query` (string, required): Search query (1-500 chars). Use English keywords like: 'search', 'user', 'tweet', 'webhook', 'pricing', 'rate limit'. Supports camelCase and underscore formats.

Output parameters:

- `cached` (boolean): Whether this response was served from cache.
- `counts` (object)
- `markdown` (string): Human-readable markdown rendering of the results.
- `max_results` (integer): Applied max results (1-20).
- `query` (string): Normalized (trimmed) search query.
- `results` (array)

### `get_twitterapi_endpoint` (~132 tokens)

Get complete documentation for a specific TwitterAPI.io endpoint.

USE THIS WHEN: You know the exact endpoint name (e.g., from search results).
RETURNS: Full details including path, parameters, cURL example, and code snippets.

Common endpoints:
\- get_user_info, get_user_followers, get_user_following
\- tweet_advanced_search, get_tweet_by_id
\- add_webhook_rule, get_webhook_rules

Input parameters:

- `endpoint_name` (string, required): Exact endpoint name (use underscores). Examples: 'get_user_info', 'tweet_advanced_search', 'add_webhook_rule'

Output parameters:

- `cached` (boolean)
- `code_snippets` (array)
- `curl_example` (string)
- `description` (string)
- `doc_url` (string)
- `endpoint_name` (string)
- `full_url` (string)
- `markdown` (string)
- `method` (string)
- `parameters` (array)
- `path` (string)
- `raw_text` (string)
- `title` (string)

### `list_twitterapi_endpoints` (~103 tokens)

List all TwitterAPI.io API endpoints organized by category.

USE THIS WHEN: You need to browse available endpoints or find endpoints by category.
CATEGORIES: user, tweet, community, webhook, stream, action, dm, list, trend

RETURNS: Endpoint names with HTTP method and path for each category.

Input parameters:

- `category` (string): Optional filter: user, tweet, community, webhook, stream, action, dm, list, trend, other

Output parameters:

- `category` (string|null)
- `endpoints` (array)
- `markdown` (string)
- `total` (integer): Number of endpoints returned (after optional category filter).
- `total_all` (integer): Total endpoints in the snapshot (before filtering).

### `get_twitterapi_guide` (~112 tokens)

Get a TwitterAPI.io page from the offline snapshot by page key.

USE THIS WHEN: You need the full content of a specific page (guides, docs, policies, contact, etc.).
TIP: Use search_twitterapi_docs if you don't know the page key.

RETURNS: Full guide content with headers, paragraphs, and code examples.

Input parameters:

- `guide_name` (string, required): Page key (from data/pages). Examples: pricing, qps_limits, privacy, contact, introduction, authentication.

Output parameters:

- `code_snippets` (array)
- `description` (string)
- `guide_name` (string)
- `headers` (array)
- `list_items` (array)
- `markdown` (string)
- `paragraphs` (array)
- `raw_text` (string)
- `title` (string)
- `url` (string)

### `get_twitterapi_url` (~127 tokens)

Fetch a TwitterAPI.io or docs.twitterapi.io URL.

USE THIS WHEN: You have a specific link and want its full content.
RETURNS: Parsed content from the offline snapshot. If not found, you can set fetch_live=true (restricted to twitterapi.io/docs.twitterapi.io).

Input parameters:

- `fetch_live` (boolean): If true and the URL is missing from the offline snapshot, fetch it live over HTTPS (allowed hosts only).
- `url` (string, required): URL to fetch. Examples: https://twitterapi.io/privacy, /pricing, docs.twitterapi.io/introduction

Output parameters:

- `description` (string)
- `kind` (string)
- `markdown` (string)
- `name` (string)
- `source` (string)
- `title` (string)
- `url` (string)

### `get_twitterapi_pricing` (~65 tokens)

Get TwitterAPI.io pricing information: credit system, endpoint costs, QPS limits.

USE THIS WHEN: You need to know API costs, credit calculations, or rate limits.
RETURNS: Pricing tiers, credit costs per endpoint, QPS limits by balance level.

Output parameters:

- `costs` (object)
- `credits_per_usd` (number)
- `markdown` (string)
- `minimum_charge` (string)
- `notes` (array)
- `qps_limits` (object)

### `get_twitterapi_auth` (~62 tokens)

Get TwitterAPI.io authentication guide: API key usage, headers, code examples.

USE THIS WHEN: You need to set up authentication or see request examples.
RETURNS: API key header format, base URL, cURL/Python/JavaScript examples.

Output parameters:

- `base_url` (string)
- `dashboard_url` (string)
- `examples` (object)
- `header` (string)
- `markdown` (string)

## Diagnostics

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

## Score history

- 2026-08-03: 67
- 2026-08-02: 67
- 2026-08-01: 26
- 2026-07-31: 26
- 2026-07-30: 35
- 2026-07-28: 53
- 2026-07-27: 24

## Links

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