MCP.Market

Xflux MCP server

by yxs1640-png·io.github.yxs1640-png/xflux·v1.2.1
No reviews yet

X/Twitter read API for agents: search, timelines, Smart Money. Claude/Cursor MCP. Not for posting.

B80/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
Growing

0 stars66 downloads/wk

Reviews

Write one

Nobody has reviewed Xflux yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Xflux tools (9)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • xflux_get_monitor_hits

    List recent hits for one XFlux monitor (read-only). Use after xflux_list_monitors when the user wants alert history for a watched @account. Create/edit monitors in the Dashboard.

  • xflux_get_tweet

    Fetch one public tweet/post by numeric status ID via XFlux. Use when the user pastes a tweet ID or needs a single post's text and engagement.

  • xflux_get_user

    X/Twitter profile lookup via XFlux. Use when the user asks for a public Twitter/X user profile, bio, follower counts, or verified status by @username. Read-only; not for posting.

  • xflux_get_user_tweets

    Fetch a public X/Twitter user timeline via XFlux. Use when the user asks what someone posted lately, KOL latest tweets, or to summarize a handle's recent activity.

  • xflux_list_monitors

    List the user's XFlux account monitors (read-only): @targets, keywords, status, webhook flag, optional recent hits. Use when they ask what they are watching on XFlux. Creating monitors requires the Dashboard, not this tool.

  • xflux_search_tweets

    Search recent public tweets/posts on X/Twitter via XFlux (same operators as X search: from:, lang:, quotes). Use when the user wants tweet search, keyword monitoring research, cashtag/hashtag scans, or agent research over live X content. Prefer this over scraping.

  • xflux_smart_money_claims

    List recent Smart Money prediction/market calls across X accounts via XFlux. Use for a feed of forward-looking claims (macro, trading, crypto, geopolitics). Optional niche and exclude list.

  • xflux_smart_money_list

    Discover ranked Smart Money X/Twitter accounts (macro, trading, crypto, geopolitics) with recent extractable forward-looking market calls. Use when the user wants new KOL/analyst accounts to follow, alpha sources, or predictor discovery — prefer this over googling long analyst prompts. Pass exclude for handles already tracked.

  • xflux_smart_money_profile

    Get one XFlux Smart Money account profile plus recent extracted prediction calls (default last 14 days). Use when digging into a specific @analyst or KOL already found via xflux_smart_money_list.

Public scan report

scanner v0.1.10 · 2026-11-02 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 4 days ago15/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Xflux compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
80/100
higher than 65% of 3,470 Web search servers
Tools
9
the typical Web search server has 5
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
66
more than 46% of 827 Web search servers with a package

What its tools let an agent do: 9 read

Release history: 3 versions in the registry since 2026-09-22, latest 2026-10-08, typically one every 14 days.

Install Xflux in Claude Code, Cursor or VS Code

Runs npx -y @xflux/xflux-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add xflux -- npx -y @xflux/xflux-mcp-server
Add to Cursor

What the publisher says

From the Xflux repository's README, as published. We do not edit it. Read it on GitHub

XFlux

Affordable & stable X/Twitter API proxy service — MVP built with Next.js 15, TypeScript, Prisma, and PostgreSQL.

Features (MVP)

  • Landing page — Marketing site with pricing and feature overview
  • User auth — Email/password registration and login (NextAuth)
  • API Keys — Generate and manage xflux_* API keys
  • REST API proxy — User profiles, tweets, search (mock + optional live Twitter API v2)
  • MCP server — Official Registry + npm (@xflux/xflux-mcp-server) for Claude Desktop & Cursor
  • Dashboard — Usage stats, API logs, quota tracking
  • Monitors — KOL tweet monitoring task management
  • Billing — Stripe Checkout subscriptions (Starter / Growth / Pro / Scale); see docs/STRIPE.md

MCP (Claude / Cursor)

Published on the MCP Registry as io.github.yxs1640-png/xflux and on npm as @xflux/xflux-mcp-server.

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

Docs: https://www.xfluxapi.com/docs/integrations/mcp

Tech Stack

  • Next.js 15 (App Router)
  • TypeScript
  • Tailwind CSS 4
  • Prisma + PostgreSQL
  • NextAuth.js
  • Recharts

Architecture

  • Vercel — Next.js app, auth, dashboard, public /api/v1/*
  • Fly.io — api-server/ (Consumer API proxy) + Dockerfile.worker (Monitor 轮询)
  • Supabase — PostgreSQL

See docs/DEPLOYMENT.md for Vercel + Fly.io deployment.

Quick Start

Prerequisites

  • Node.js 20+
  • PostgreSQL database (local, Neon, Supabase, or Vercel Postgres)

Supabase 数据库配置

Supabase 新版界面里，连接串不在 Project Settings → Database，而在：

项目首页顶部 → 点击 Connect 按钮

只有 DIRECT_URL 时（本地开发够用）

Project Overview 里若已有 DIRECTURL（端口 5432），在 .env 里 两个变量都填同一个值** 即可：

DATABASE_URL="你的DIRECT_URL完整连接串"
DIRECT_URL="你的DIRECT_URL完整连接串"

示例格式：

DATABASE_URL="postgresql://postgres:你的密码@db.abcdefgh.supabase.co:5432/postgres"
DIRECT_URL="postgresql://postgres:你的密码@db.abcdefgh.supabase.co:5432/postgres"

然后执行：

npx prisma db push
npm run dev

需要 DATABASE_URL（6543 池化连接）时

  1. 项目首页 → Connect
  2. 选择 ORMs → Prisma，或选 Transaction pooler（端口 6543）
  3. 复制 Transaction 连接串 → 填入 DATABASE_URL，末尾加 ?pgbouncer=true
  4. DIRECTURL 仍用 5432 直连（Connect → Direct connection** 或 Overview 里的值）

本地开发用 5432 直连即可；部署 Vercel 时再把 DATABASE_URL 换成 6543 池化连接。

部署到 Vercel 时，在 Environment Variables 里添加 DATABASEURL、DIRECTURL、NEXTAUTHURL、NEXTAUTHSECRET。

Setup

cd ~/Projects/xflux
npm install

cp .env.example .env
# Default uses SQLite — no Postgres install needed

npx prisma db push
npm run dev

Local database options:

For Docker Postgres, change prisma/schema.prisma provider back to postgresql and set: DATABASE_URL="postgresql://xflux:xflux@localhost:5432/xflux?schema=public"

Open http://localhost:3000

Environment Variables

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Xflux: common questions

Is Xflux MCP server safe?
Mostly: it is graded B (80/100). Read the Xflux safety report
How do I install Xflux?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Xflux need an API key?
Yes. The registry entry asks for XFLUX_API_KEY.
Is Xflux maintained?
The last commit was 6 days ago (2026-10-29). The latest release is v1.2.1.
What can I use instead of Xflux?
Servers from other publishers that do the same job: Reddit Buddy MCP server.
How does Xflux compare with other Web search MCP servers?
safety score 80/100 (higher than 65% of 3,470 Web search servers); tools 9 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Xflux

Same job from other publishers: the closest match first, then the best rated.

  • Reddit Buddy
    Browse Reddit RSS; approved API access for search, analysis, and optional posting.
    A