xflux

Name: xflux
Author: yxs1640-png

Local

github.com/yxs1640-pngSocial Media0Updated 1d ago

Repository

About xflux

xflux is a read-only X/Twitter data service for agents and apps, covering profiles, posts, search, account monitoring, and Smart Money accounts. Its MCP server makes the same read API available in clients such as Claude Desktop and Cursor.

Key features

01Read public profiles and timelines
02Search tweets and fetch individual posts
03List monitors and retrieve their hits
04View ranked Smart Money accounts and calls
05Deliver signed monitor webhooks on paid plans

Use cases

01Search recent posts about a topic
02Review an account’s timeline or profile
03Track monitored accounts and inspect hits

MCP support

The MCP server exposes the XFlux read API through tools for profiles, search, timelines, tweets, monitors, and Smart Money data. It connects to MCP clients using the XFLUX_API_KEY environment variable.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "yxs1640-png-xflux": {
      "command": "npx",
      "args": [
        "-y",
        "@xflux/xflux-mcp-server"
      ],
      "env": {
        "XFLUX_API_KEY": "<XFLUX_API_KEY>",
        "XFLUX_API_BASE": "<XFLUX_API_BASE>"
      }
    }
  }
}

Run commandnpx -y @xflux/xflux-mcp-server

Environment variables to set

XFLUX_API_KEYSecretAPI key from https://www.xfluxapi.com/dashboard/api-keys (free tier available)

XFLUX_API_BASEOptional API base URL (default https://www.xfluxapi.com/api/v1)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@xflux/xflux-mcp-server1.2.1stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
username	string	Yes	Handle without @, e.g. elonmusk

Details

From the project README

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.

Method	Path	Description
GET	`/api/v1/users/:username`	Profile
GET	`/api/v1/users/:username/tweets`	Timeline
GET	`/api/v1/tweets/:id`	One tweet
GET	`/api/v1/search?q=`	Search tweets
GET	`/api/v1/monitors`	Your monitors (read-only)
GET	`/api/v1/monitors/:id/hits`	Hits 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"
      }
    }
  }
}

Tool	Description
`xflux_get_user`	Profile by @username
`xflux_search_tweets`	Search recent tweets
`xflux_get_user_tweets`	User timeline
`xflux_get_tweet`	One tweet by ID
`xflux_list_monitors`	List monitors (read-only)
`xflux_get_monitor_hits`	Hits for one monitor
`xflux_smart_money_list`	Ranked Smart Money accounts
`xflux_smart_money_profile`	One Smart Money profile
`xflux_smart_money_claims`	Recent 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.