Back to search
twitterdown-mcp-server
MCP serverGitHub
TwitterDown MCP server: resolve public X (Twitter) posts into video links from any MCP client. npm: @twitterdown/mcp-server
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/bestlemoon--twitterdown-mcp-server)HTML
<a href="/listings/bestlemoon--twitterdown-mcp-server"><img src="/api/listings/bestlemoon--twitterdown-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 90 lines
- # TwitterDown MCP server
- Resolve public X posts and manage a TwitterDown Agent API account from an MCP
- client. The server uses stdio and runs on Node.js 20 or later. After npm release,
- launch it with your MCP client or run the command directly to open the stdio
- transport.
- ```sh
- npx -y @twitterdown/mcp-server
- ```
- ## Claude Desktop
- Add the server to `claude_desktop_config.json` and restart Claude Desktop.
- ```json
- {
- "mcpServers": {
- "twitterdown": {
- "command": "npx",
- "args": ["-y", "@twitterdown/mcp-server"],
- "env": {
- "TWITTERDOWN_API_KEY": "<your Agent API key>"
- }
- }
- }
- }
- ```
- Keep the configuration private. To register without an existing key, omit
- `TWITTERDOWN_API_KEY`.
- ## VS Code
- Add this to your VS Code MCP user configuration. VS Code prompts for a masked
- key and stores it for subsequent starts. To start without a key, omit both the
- `env` entry and the `inputs` block.
- [VS Code MCP configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)
- ```json
- {
- "servers": {
- "twitterdown": {
- "type": "stdio",
- "command": "npx",
- "args": ["-y", "@twitterdown/mcp-server"],
- "env": {
- "TWITTERDOWN_API_KEY": "${input:twitterdown-api-key}"
- }
- }
- },
- "inputs": [
- {
- "id": "twitterdown-api-key",
- "type": "promptString",
- "description": "TwitterDown Agent API key",
- "password": true
- }
- ]
- }
- ```
- `TWITTERDOWN_API_BASE` defaults to `https://twitterdown.com`. Set it in the
- server's `env` for a trusted alternate API origin.
- ## Tools
- | Tool | Arguments | Result |
- | --- | --- | --- |
- | `register_account` | None | Completes proof of work and returns the account ID, API key and recovery token. The proof search is capped at 10 seconds. |
- | `get_claim_url` | None | Returns a private claim URL and expiry. |
- | `parse_tweet` | `url`, optional `idempotency_key` | Returns video URLs and metadata, or a pending request ID and status URL. An omitted key is generated as a UUID. |
- | `get_account` | None | Returns account quota, wallet and pricing information. |
- | `get_request` | `request_id` | Reads a pending or terminal request and any stored result. |
- Save registration credentials securely. MCP clients can retain tool output in
- their conversation history. Set the saved key in the client configuration and
- restart the server before calling authenticated tools. Share claim URLs privately.
- For a pending parse, wait for the returned `retry_after` value when present,
- then call `get_request` using the response's `data.request_id`. Supply a
- stable idempotency key if you may need to replay a parse after an uncertain
- outcome. The [Agent API guide](https://twitterdown.com/agent.md) covers the
- underlying REST contract, ownership, credential recovery, quota and billing.
- ## Local development
- From the repository root, run `npm install` and `npm test`. The SDK integration
- test starts the server over stdio and uses a loopback HTTP stub.
- Run `node server.js` directly from an MCP client for local development.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.