Skip to content
Back to search

twitterdown-mcp-server

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bestlemoon--twitterdown-mcp-server/badge.svg)](/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
  1. # TwitterDown MCP server
  2. Resolve public X posts and manage a TwitterDown Agent API account from an MCP
  3. client. The server uses stdio and runs on Node.js 20 or later. After npm release,
  4. launch it with your MCP client or run the command directly to open the stdio
  5. transport.
  6. ```sh
  7. npx -y @twitterdown/mcp-server
  8. ```
  9. ## Claude Desktop
  10. Add the server to `claude_desktop_config.json` and restart Claude Desktop.
  11. ```json
  12. {
  13. "mcpServers": {
  14. "twitterdown": {
  15. "command": "npx",
  16. "args": ["-y", "@twitterdown/mcp-server"],
  17. "env": {
  18. "TWITTERDOWN_API_KEY": "<your Agent API key>"
  19. }
  20. }
  21. }
  22. }
  23. ```
  24. Keep the configuration private. To register without an existing key, omit
  25. `TWITTERDOWN_API_KEY`.
  26. ## VS Code
  27. Add this to your VS Code MCP user configuration. VS Code prompts for a masked
  28. key and stores it for subsequent starts. To start without a key, omit both the
  29. `env` entry and the `inputs` block.
  30. [VS Code MCP configuration reference](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)
  31. ```json
  32. {
  33. "servers": {
  34. "twitterdown": {
  35. "type": "stdio",
  36. "command": "npx",
  37. "args": ["-y", "@twitterdown/mcp-server"],
  38. "env": {
  39. "TWITTERDOWN_API_KEY": "${input:twitterdown-api-key}"
  40. }
  41. }
  42. },
  43. "inputs": [
  44. {
  45. "id": "twitterdown-api-key",
  46. "type": "promptString",
  47. "description": "TwitterDown Agent API key",
  48. "password": true
  49. }
  50. ]
  51. }
  52. ```
  53. `TWITTERDOWN_API_BASE` defaults to `https://twitterdown.com`. Set it in the
  54. server's `env` for a trusted alternate API origin.
  55. ## Tools
  56. | Tool | Arguments | Result |
  57. | --- | --- | --- |
  58. | `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. |
  59. | `get_claim_url` | None | Returns a private claim URL and expiry. |
  60. | `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. |
  61. | `get_account` | None | Returns account quota, wallet and pricing information. |
  62. | `get_request` | `request_id` | Reads a pending or terminal request and any stored result. |
  63. Save registration credentials securely. MCP clients can retain tool output in
  64. their conversation history. Set the saved key in the client configuration and
  65. restart the server before calling authenticated tools. Share claim URLs privately.
  66. For a pending parse, wait for the returned `retry_after` value when present,
  67. then call `get_request` using the response's `data.request_id`. Supply a
  68. stable idempotency key if you may need to replay a parse after an uncertain
  69. outcome. The [Agent API guide](https://twitterdown.com/agent.md) covers the
  70. underlying REST contract, ownership, credential recovery, quota and billing.
  71. ## Local development
  72. From the repository root, run `npm install` and `npm test`. The SDK integration
  73. test starts the server over stdio and uses a loopback HTTP stub.
  74. Run `node server.js` directly from an MCP client for local development.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.