English Français العربية

io.github.yxs1640-png/xflux

Official registry Search and web

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

Source code Documentation

What can you do with 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.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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
JSON configuration (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>"
            }
        }
    }
}

Environment variables

  • XFLUX_API_KEY required 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

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is io.github.yxs1640-png/xflux?

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

How do I install io.github.yxs1640-png/xflux?

It runs on your machine. In 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. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.yxs1640-png/xflux need an API key?

Yes. It expects XFLUX_API_KEY, which you set in its configuration.

Is io.github.yxs1640-png/xflux open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.yxs1640-png/xflux?

It is published by yxs1640-png. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.