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
