yxs1640-png/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
bash
curl -H "Authorization: Bearer xfluxYOURKEY" \
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.
bash
export XFLUXAPIKEY=xfluxyourkeyhere
npx -y @xflux/xflux-mcp-server
json
"mcpServers": {
"xflux": {
"command": "npx",
"args": ["-y", "@xflux/xflux-mcp-server"],
"env": {
"XFLUXAPIKEY": "xfluxyourkeyhere"
| Tool | Description |
| xfluxgetuser | Profile by @username |
| xfluxsearchtweets | Search recent tweets |
| xfluxgetusertweets | User timeline |
| xfluxgettweet | One tweet by ID |
| xfluxlistmonitors | List monitors (read-only) |
| xfluxgetmonitorhits | Hits for one monitor |
| xfluxsmartmoneylist | Ranked Smart Money accounts |
| xfluxsmartmoneyprofile | One Smart Money profile |
| xfluxsmartmoneyclaims | Recent Smart Money calls |
Server details: mcp-server/README.md. Docs: https://www.xfluxapi.com/docs/integrations/mcp