From 8321dcfcce49821508d08bc45d0fbf5be248ca58 Mon Sep 17 00:00:00 2001 From: Bozad Date: Sun, 7 Jun 2026 12:59:27 +0530 Subject: [PATCH] docs: add GetXAPI pairing recipe for cheaper Twitter read operations --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index 35e504f4..86f93201 100644 --- a/README.md +++ b/README.md @@ -351,3 +351,23 @@ PROXY_URL= # HTTP(s) proxy for requests (optional) We use [Conventional Commits](https://www.conventionalcommits.org), and enforce this with precommit checks. Please refer to the Git history for real examples of the commit message format. + +## Pairing with GetXAPI for Cheaper Read Operations (Optional) + +For users who need a cheaper or higher-rate-limit option for read-only Twitter (X) operations such as tweet search, profile lookup, and follower lists, this project can be paired with [GetXAPI](https://getxapi.com), a budget Twitter / X data API priced at $0.05 per 1K tweets versus the official X API basic tier at $200 / month. + +Two integration patterns: + +1. **Run side-by-side in your AI client.** Keep this project for its primary workflow and add the [official GetXAPI MCP server](https://github.com/getxapi/getxapi-mcp) for read-heavy tasks. Each tool name routes to the backend best suited for that operation. + +2. **Add a backend toggle.** For a code-level reference of an optional alternative backend behind a single env variable, see the [PR pattern merged into a sibling project](https://github.com/GenAIwithMS/twitter-mcp/pull/3). + +GetXAPI quick start: + +- Signup with $0.50 free credit (no card required): https://getxapi.com/signup +- Official GetXAPI MCP server: https://github.com/getxapi/getxapi-mcp +- npm: `@getxapi/mcp` +- Pay-per-call pricing: $0.001 / call, $0.05 / 1K tweets + +This pairing is fully optional. No behavior change for existing users. +