SocialForex

io.github.namlxuit056Published by GitHub account namlxuit056v0.1.0Updated Oct 24, 2026

Live forex, gold & crypto quotes, economic calendar, screener, currency strength, lot-size calc

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinanceData & Analytics

Overview

AI-generated overview

A trading-information MCP server offering live forex, gold and crypto quotes, an economic calendar, technical screener, currency strength, market sessions and a

What you can do
Get current bid/ask and daily change for forex majors and minors, gold, silver, oil and crypto. Look up upcoming or recent macro events with impact, forecast, previous and actual values in UTC. Read per-symbol technicals across M15, H1, H4 and D1, including recommendation, RSI, ADX, MACD, Bollinger position, stochastic state and ATR. Compare relative strength of the eight major currencies, strongest first. Check whether the forex market is open and which sessions and overlaps are active or upcoming. Calculate lot size from a stop loss and risk percentage.
When to use it
Use it when you want quick forex, gold, energy or crypto quotes, macro event schedules, technical ratings, currency strength or session status inside a chat, or need a lot size from a risk percentage. Suited to market browsing and pre-trade information gathering.
Requirements
A remote MCP endpoint; no local install or package needed. No account, API key or environment variables are declared. Network access to the service is required.
Before you install
Content is for education and information only, and the server asks assistants to remind users it is not investment advice. Leveraged trading carries high risk of loss; quotes, ratings and strength data may be delayed or wrong and should not be the sole basis for decisions. The position-size calculation assumes a USD account. Data comes from a third-party service.

Installation

In SourceWeft

  1. Open SocialForex in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.namlxuit056%2Fsocial-forex/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "socialforex": {
      "type": "http",
      "url": "https://toolforex.xyz/api/mcp"
    }
  }
}

README

SocialForex

Forex tools, signals, journal and community for traders — open source.

[Live site] [License: AGPL v3] [Support with PayPal] [Sponsor]

👉 Try it live: toolforex.xyz

Tiếng Việt · Features · Self-hosting · Sponsor

[SocialForex home page]

SocialForex is a full-stack trading companion for retail forex / gold / crypto traders. It combines live market data, a community signal room, MT5 copy-trading, a deep trading journal with AI reviews, and an academy for beginners — in Vietnamese and English.

⚠️ Everything in this project is for education and information only. It is not investment advice. Trading leveraged products carries a high risk of losing money.

Features

📈 Market data

Live quotes — forex, metals, energy and crypto, auto-refreshing
[Image]		TradingView chart with watchlist and AI expert analysis
[Image]
Market screener — M15/H1/H4/D1 ratings, RSI, ADX per pair
[Image]		Currency-strength heatmap across 8 majors
[Image]
Economic calendar — VN/UTC time, impact filters, AI explanation
[Image]		Live desk — chart + news risk + lot sizing before every trade
[Image]

📡 Signals & community

Signal room — free and VIP signals, MT5-verified, comments & votes
[Image]		Confident technical signals — 4H Strong confirmed by H1 + M15, accuracy tracked per source (TradingView, CFTC COT, OANDA, Myfxbook, IG)
[Image]
Leaderboard — win rate, profit factor, XP; follow or copy
[Image]		Community sentiment — long/short ratio from active signals
[Image]
MT5 copy-trading — Expert Advisor with fixed-lot / %-risk sizing
[Image]		MT5 positions — live P/L, auto-close before weekend / end of day / at breakeven, AI portfolio review
[Image]

📒 Trading journal & discipline

Trading journal — auto-synced from MT5, win rate, payoff, expectancy
[Image]		Advanced stats — discipline scorecard, tilt days, mistake tags, MAE/MFE, weekly & daily AI reviews
[Image]
Daily trading plan — pre-trade checklist, risk limits, streaks
[Image]		AI Auto-Scalp — multi-symbol scalping analysis with quality thresholds
[Image]
Price alerts with web push notifications
[Image]		Dashboard — daily activity, XP level, referral program
[Image]

🎓 Learning

Academy / Wiki — price action path from beginner to advanced
[Image]		AI forex articles — daily analysis enriched with web search and chart snapshots
[Image]
Beginner mission board — 16 auto-verified tasks with XP
[Image]		Calculators — position size, pivot points, margin
[Image]
Backtest — Monte Carlo equity simulation
[Image]		Dark mode & mobile-first
[Image] [Image]

Screenshots are regenerated with node scripts/screenshots.mjs (account balances are blurred automatically).

🤖 Use it from your AI assistant (MCP)

SocialForex is also a public MCP server — quotes, economic calendar, screener, currency strength, trading sessions and a position-size calculator, right inside Claude, Cursor, VS Code or DeepSeek Harness:

bash
claude mcp add --transport http socialforex https://toolforex.xyz/api/mcp

See docs/mcp.md for the tool list and other clients.

[An AI assistant answering "Any BTC signal?" with live SocialForex screener data over MCP]
Asking an assistant "BTC có tín hiệu gì không?" — it calls the SocialForex MCP tools and answers from live screener data.

Tech stack

  • Next.js 16 (App Router) + React 19, Tailwind CSS v4 + shadcn/ui
  • Prisma 7 + PostgreSQL
  • NextAuth v5 (credentials, JWT sessions)
  • next-intl v4 — Vietnamese (default) and English
  • AI providers: DeepSeek, Groq, OpenAI or Anthropic (configurable in the admin panel)
  • MetaTrader 5 Expert Advisors for copy-trading and position bridging (docs/mt5)
  • Vitest unit tests, Playwright end-to-end tests

Getting started

Requirements: Node.js 20+, Docker (for PostgreSQL).

bash
git clone https://github.com/namlxuit056/social-forex.gitcd social-forexnpm installcp .env.example .env          # then fill in DATABASE_URL and AUTH_SECRETnpm run docker:up             # start PostgreSQLnpm run db:deploy             # apply migrationsnpm run db:seed               # optional sample datanpm run dev                   # http://localhost:3000

Only DATABASE_URL, AUTH_SECRET and NEXTAUTH_URL are required. Every other key in .env.example (AI providers, Telegram, PayPal, OANDA, Myfxbook, Vercel Blob…) turns on an optional feature.

Useful commands:

bash
npm run lint      # ESLintnpm test          # Vitestnpm run build     # production build

Self-hosting on your own machine with pm2 + Cloudflare Tunnel is documented in docs/self-hosting.md.

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md. Please report security problems privately as described in SECURITY.md.

Support the project

SocialForex is built and run by one developer and hosted at toolforex.xyz. If it helps your trading, you can support hosting, data and AI costs:

License

GNU AGPL-3.0. You may use, modify and self-host this project; if you run a modified version as a public service, you must publish your source code under the same license.

Tiếng Việt

SocialForex là nền tảng mã nguồn mở hỗ trợ trader forex / vàng / crypto: giá realtime, phòng tín hiệu cộng đồng, copy-trade MT5, nhật ký giao dịch có AI chấm điểm kỷ luật, lịch kinh tế, screener, heatmap và học viện cho người mới.

Mọi nội dung chỉ mang tính giáo dục, không phải lời khuyên đầu tư.

Source: README.md at commit 97bc8da

Tools

6

get_quotes

Live quotes

Current bid/ask and daily % change for forex majors/minors, gold, silver, oil and crypto.

Parameterssymbols

get_economic_calendar

Economic calendar

Upcoming (and optionally recent) macro events with impact, forecast, previous and actual values. Times are UTC.

ParametershoursBackminImpactcurrencieshoursAhead

get_screener

Technical screener

Per-symbol technicals: TradingView recommendation per timeframe (M15/H1/H4/D1, -1 strong sell … +1 strong buy), RSI, ADX, MACD, Bollinger position, stochastic state and ATR.

Parameterssymbols

get_currency_strength

Currency strength

Relative strength of the 8 major currencies, derived from today's % change across available pairs. Sorted strongest first.

Takes no parameters.

get_market_sessions

Trading sessions

Whether the forex market is open, active sessions (Sydney/Tokyo/London/New York), current and upcoming overlaps.

Takes no parameters.

calculate_position_size

Position size calculator

Lot size so that hitting the stop loss loses `riskPct` % of the balance. Account currency is assumed to be USD.

ParametersentryrequiredsymbolrequiredbalancerequiredriskPctrequiredleveragestopLossrequired

Version history

1
  1. v0.1.0LatestOct 24, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts