Connect Claude or Cursor to X Data via XFlux MCP

What the XFlux MCP server does

Model Context Protocol (MCP) lets Claude Desktop and Cursor call tools against your XFlux API key. The package is @xflux/xflux-mcp-server (registry id io.github.yxs1640-png/xflux).

Tools cover read API operations: user profiles, search, timelines, tweet lookup, read-only monitor list/hits, and Smart Money discovery. Creating monitors and webhook URLs still happens in the Dashboard — MCP stays read-oriented.

Not the other “xflux”

There are unrelated projects that also use the name “xflux” (for example Figma-oriented MCP tooling). This guide is only for XFlux the X/Twitter API at xfluxapi.com — package scope @xflux/xflux-mcp-server.

Install and run

You need Node 18+ and an API key from the Dashboard (prefix xflux_). MCP calls count against your plan’s REST quota like any other request.

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

Cursor and Claude Desktop config

Add the same JSON block to Cursor MCP settings or Claude’s claude_desktop_config.json, then restart the client.

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

Useful agent patterns

Discover forward-looking accounts with xflux_smart_money_list (pass exclude for handles you already track), inspect timelines, then open Dashboard → Monitors to watch them with webhooks.

Marketing overview: /mcp. Full tool list: /docs/integrations/mcp. Smart Money hub: /predictors.