English Français العربية

io.github.yxs1640-png/xflux

Registre officiel Recherche et web

X/Twitter read API for agents: search, timelines, Smart Money. Claude/Cursor MCP. Not for posting.

Code source Documentation

Que pouvez-vous faire avec io.github.yxs1640-png/xflux ?

  • Read API — public profiles, timelines, single tweets, and search. Bearer key, JSON.
  • Monitors — watch @handles on a schedule. New tweets are delivered with a signed webhook on paid plans. Create monitors in the Dashboard, not by posting to the API.
  • Smart Money — ranked KOL accounts and recent calls (read-only).
  • MCP server — the same read API inside Claude Desktop, Cursor, and other MCP clients.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @xflux/xflux-mcp-server
Claude Code 
claude mcp add xflux -e 'XFLUX_API_KEY=<your xflux_api_key>' -e 'XFLUX_API_BASE=<XFLUX_API_BASE>' -- npx -y @xflux/xflux-mcp-server@1.2.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xflux": {
            "command": "npx",
            "args": [
                "-y",
                "@xflux/xflux-mcp-server@1.2.1"
            ],
            "env": {
                "XFLUX_API_KEY": "<your xflux_api_key>",
                "XFLUX_API_BASE": "<XFLUX_API_BASE>"
            }
        }
    }
}

Variables d'environnement

  • XFLUX_API_KEY obligatoire secret API key from https://www.xfluxapi.com/dashboard/api-keys (free tier available)
  • XFLUX_API_BASE Optional API base URL (default https://www.xfluxapi.com/api/v1)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. XFlux
  2. What it does
  3. REST API
  4. MCP
  5. Recipes
  6. This repository
  7. License

XFlux

Read-only X/Twitter API for agents and apps: profiles, search, timelines, account monitors with signed webhooks, and Smart Money. Not for posting.

Site: xfluxapi.com · MCP: xfluxapi.com/mcp · Agents: llms.txt

Free tier: 1,000 calls/month, 1 monitor, no credit card. Paid plans add signed HTTP webhooks and higher quotas.

What it does

  • Read API — public profiles, timelines, single tweets, and search. Bearer key, JSON.
  • Monitors — watch @handles on a schedule. New tweets are delivered with a signed webhook on paid plans. Create monitors in the Dashboard, not by posting to the API.
  • Smart Money — ranked KOL accounts and recent calls (read-only).
  • MCP server — the same read API inside Claude Desktop, Cursor, and other MCP clients.

This service does not post tweets, send DMs, or require official X API approval.

REST API

Base URL: https://www.xfluxapi.com/api/v1

curl -H "Authorization: Bearer xflux_YOUR_KEY" \
  https://www.xfluxapi.com/api/v1/users/x

Get a key at Dashboard → API Keys.

MethodPathDescription
GET/api/v1/users/:usernameProfile
GET/api/v1/users/:username/tweetsTimeline
GET/api/v1/tweets/:idOne tweet
GET/api/v1/search?q=Search tweets
GET/api/v1/monitorsYour monitors (read-only)
GET/api/v1/monitors/:id/hitsHits for one monitor (read-only)

Docs: https://www.xfluxapi.com/docs

MCP

Registry name io.github.yxs1640-png/xflux. npm package @xflux/xflux-mcp-server.

export XFLUX_API_KEY=xflux_your_key_here
npx -y @xflux/xflux-mcp-server
{
  "mcpServers": {
    "xflux": {
      "command": "npx",
      "args": ["-y", "@xflux/xflux-mcp-server"],
      "env": {
        "XFLUX_API_KEY": "xflux_your_key_here"
      }
    }
  }
}
ToolDescription
xflux_get_userProfile by @username
xflux_search_tweetsSearch recent tweets
xflux_get_user_tweetsUser timeline
xflux_get_tweetOne tweet by ID
xflux_list_monitorsList monitors (read-only)
xflux_get_monitor_hitsHits for one monitor
xflux_smart_money_listRanked Smart Money accounts
xflux_smart_money_profileOne Smart Money profile
xflux_smart_money_claimsRecent Smart Money calls

Server details: mcp-server/README.md. Docs: https://www.xfluxapi.com/docs/integrations/mcp

Recipes

This repository

The public product runs from this repo: the website on Vercel, the API proxy and monitor worker on Fly.io, and the MCP package in mcp-server/. Deploy notes: docs/DEPLOYMENT.md.

License

MIT

Questions fréquentes

Qu'est-ce que io.github.yxs1640-png/xflux ?

X/Twitter read API for agents: search, timelines, Smart Money. Claude/Cursor MCP. Not for posting.

Comment installer io.github.yxs1640-png/xflux ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add xflux -e 'XFLUX_API_KEY=<your xflux_api_key>' -e 'XFLUX_API_BASE=<XFLUX_API_BASE>' -- npx -y @xflux/xflux-mcp-server@1.2.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.yxs1640-png/xflux ?

Oui. Il attend XFLUX_API_KEY, à renseigner dans sa configuration.

io.github.yxs1640-png/xflux est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.yxs1640-png/xflux ?

Il est publié par yxs1640-png. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.