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

• Connect Slack to Twitter alerts
• Free X API: 1,000 calls, no card
• Twitter search operators for agents

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