XFlux MCP server

Use the Model Context Protocol to give AI agents access to the XFlux read API — search, profiles, timelines, and Smart Money discovery. Monitors and webhooks are still configured in the Dashboard; the MCP layer stays read-oriented.

What this is (and isn't)

Is: on-demand tweet/user lookups, Smart Money account discovery (exclude list + recent calls), plus read-only access to your monitor list and hits.
Isn't: a replacement for creating monitors, streaming, or webhook delivery — configure those in the Dashboard.

Install: @xflux/xflux-mcp-server · Registry: io.github.yxs1640-png/xflux

Available tools

xflux_get_user — profile by @username (compact)
xflux_search_tweets — search recent posts (compact)
xflux_get_user_tweets — user timeline (compact)
xflux_get_tweet — single tweet by ID (compact)
xflux_list_monitors — your monitors (read-only; optional recent hits)
xflux_get_monitor_hits — hits for one monitor (read-only)
xflux_smart_money_list — ranked Smart Money accounts + recent calls; pass exclude for handles you already track
xflux_smart_money_profile — one account + recent prediction calls
xflux_smart_money_claims — recent calls across accounts

Smart Money for agents

When an agent needs to find new X accounts that make forward-looking macro / market calls, use xflux_smart_money_list (with an exclude list) instead of pasting a long analyst prompt into Google. Hub: /predictors. Then open the Dashboard to add a Monitor on any @handle.

Install & run (one-shot)

1) Get a free key at /register → Dashboard → API Keys. 2) Paste the JSON below into Cursor or Claude Desktop. 3) Restart, then say “Using XFlux…”. Package: @xflux/xflux-mcp-server · Registry: io.github.yxs1640-png/xflux · Node 18+.

export XFLUX_API_KEY=xflux_your_key_here
npx -y @xflux/xflux-mcp-server

Cursor / Claude Desktop config

Cursor: Settings → MCP → Edit config. Claude Desktop: claude_desktop_config.json. Same block; restart after saving.

{
  "mcpServers": {
    "xflux": {
      "command": "npx",
      "args": ["-y", "@xflux/xflux-mcp-server"],
      "env": {
        "XFLUX_API_KEY": "xflux_your_key_here"
      }
    }
  }
}

Example prompts

Using XFlux, search recent English tweets about federal reserve rate cuts and summarize.
Using XFlux, pull @elonmusk's profile and latest tweets.
Using XFlux Smart Money, list 4 MACRO accounts from the last 14 days.
Using XFlux, list my monitors and show recent hits.

Agent discovery (no Google required)

Browsing agents can fetch a machine-readable map at /llms.txt (and /llms-full.txt). Once this MCP is installed, tools are callable directly — product overview also lives at /mcp.

Monitors + MCP together

Typical pattern: discover accounts with xflux_smart_money_list, explore with search/timeline tools, create monitors in the Dashboard, then inspect hits with xflux_list_monitors / xflux_get_monitor_hits. For production alerts, use trading keyword templates and route webhooks to Make.com per the Make guide.

API limits

MCP calls count against your plan quota like any REST request. See Plans & Limits.