FxSocket

npx add-mcp 'https://mcp.fxsocket.com/mcp'

MetaTrader MCP server

Cấp cho một AI agent quyền truy cập chỉ đọc vào các tài khoản MetaTrader 4 và MetaTrader 5 của bạn. Máy chủ FxSocket MCP cho phép Claude, Cursor, VS Code và bất kỳ ứng dụng khách Model Context Protocol nào khác trả lời các câu hỏi về giao dịch của bạn: số dư và vốn chủ sở hữu trên các tài khoản, những gì đang mở ngay lúc này, tháng trước diễn ra thế nào, báo giá trực tiếp và lịch sử giá. Nó chỉ đọc. Không công cụ nào có thể đặt, sửa đổi hoặc đóng lệnh.

URL máy chủ https://mcp.fxsocket.com/mcp

1. Tạo khóa API chỉ đọc

Trên trang API Key, hãy tạo một khóa chỉ đọc. Khóa này bắt đầu bằng fxs_ro_, có thể gọi mọi công cụ ở đây, và cũng không thể giao dịch qua bất kỳ endpoint nào khác. Hãy đặt tên và giới hạn nó cho các tài khoản mà agent nên thấy, và agent sẽ không bao giờ biết các tài khoản khác tồn tại. Khóa fxs_live_ đầy đủ của bạn cũng dùng được, nhưng một agent không có nhu cầu dùng loại khóa đó.

2. Kết nối ứng dụng khách của bạn

Các ứng dụng khách nhận URL máy chủ từ xa và một header sẽ kết nối trực tiếp. Các ứng dụng khách chỉ khởi chạy máy chủ cục bộ, chẳng hạn như Claude Desktop, sẽ dùng Docker image.

claude mcp add --transport http fxsocket https://mcp.fxsocket.com/mcp \
  --header "X-API-Key: fxs_ro_xxx"

{
  "mcpServers": {
    "fxsocket": {
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "servers": {
    "fxsocket": {
      "type": "http",
      "url": "https://mcp.fxsocket.com/mcp",
      "headers": { "X-API-Key": "fxs_ro_xxx" }
    }
  }
}

{
  "mcpServers": {
    "fxsocket": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FXSOCKET_API_KEY", "fxsocket/mcp"],
      "env": { "FXSOCKET_API_KEY": "fxs_ro_xxx" }
    }
  }
}

Mọi ứng dụng khách khác đều hoạt động theo cùng cách: trỏ nó tới https://mcp.fxsocket.com/mcp với khóa trong header X-API-Key (Authorization: Bearer cũng được chấp nhận), hoặc chạy Docker image như một máy chủ cục bộ.

Công cụ

Tám công cụ, tất cả đều chỉ đọc. Mỗi công cụ được thiết kế xoay quanh một câu hỏi thay vì một endpoint, nên “những gì đang mở trên các tài khoản của tôi” là một lệnh gọi đọc mọi terminal cùng lúc.

• list_accounts: Mọi tài khoản mà khóa có thể thấy, với id, biệt danh, nền tảng, máy chủ, login và trạng thái kết nối, tùy chọn kèm số dư, vốn chủ sở hữu và tổng theo từng loại tiền. Agent gọi công cụ này trước tiên.
• get_account: Một tài khoản đầy đủ: số dư, vốn chủ sở hữu, ký quỹ, mức ký quỹ và đòn bẩy, các cài đặt tài khoản như mức stop-out, và tình trạng terminal.
• get_open_positions: Các vị thế đang mở và lệnh chờ trên các tài khoản, có thể lọc theo symbol và loại, kèm lợi nhuận thả nổi, swap và tổng theo từng loại tiền.
• get_trade_history: Các giao dịch đã đóng trong một khoảng thời gian (mặc định 7 ngày gần nhất, tối đa 366), với số lệnh thắng, thua, tỷ lệ thắng, lợi nhuận ròng, giao dịch tốt nhất và tệ nhất, và phân tích theo symbol.
• search_symbols: Tên symbol chính xác của broker. EURUSD là EURUSD.sd hoặc EURUSDm ở một số broker, nên agent tra cứu trước khi hỏi giá.
• get_quotes: Giá bid, ask và spread trực tiếp cho tối đa 20 symbol.
• get_symbol_info: Thông số hợp đồng: số chữ số thập phân, kích thước hợp đồng, giá trị tick, giới hạn khối lượng, tỷ lệ swap, hoa hồng và phiên giao dịch.
• get_price_history: Nến OHLC cho một symbol và khung thời gian, tối đa 500 nến mỗi lần gọi.

Những gì bạn có thể hỏi

• “Tổng vốn chủ sở hữu của tôi trên tất cả tài khoản là bao nhiêu, theo từng loại tiền?”
• “Những vị thế đang mở nào hiện đang lỗ, và lỗ bao nhiêu?”
• “Tỷ lệ thắng của tôi trên XAUUSD tháng trước là bao nhiêu, và giao dịch tệ nhất của tôi là gì?”
• “So sánh spread EURUSD trên từng broker của tôi.”
• “Lấy 200 nến H1 gần nhất của GBPUSD và mô tả xu hướng.”

Chỉ đọc theo thiết kế

Máy chủ không thể giao dịch vì những gì mã của nó có thể truy cập, chứ không phải vì một cài đặt: mọi công cụ đều đọc từ terminal và không công cụ nào có thể gửi lệnh. Vì vậy, một agent bị nhầm lẫn hay bị thao túng vẫn không thể mở, thay đổi hoặc đóng một vị thế.

Tiền được báo cáo theo loại tiền gửi của từng tài khoản và không bao giờ được cộng gộp giữa các loại tiền; các công cụ trả về tổng theo từng loại tiền để mô hình không phải tự làm phép tính đó. Thời gian là giờ máy chủ của broker, như mọi nơi khác trong API.

Giới hạn: 60 yêu cầu mỗi phút cho mỗi người dùng, tối đa 50 tài khoản và 300 dòng lệnh hoặc giao dịch trong một phản hồi. Số đếm và tổng luôn bao gồm toàn bộ; chỉ danh sách dòng bị cắt bớt.

Chạy cục bộ với Docker

Image fxsocket/mcp chạy máy chủ như một tiến trình stdio cục bộ, dành cho các ứng dụng khách tự khởi chạy máy chủ của chúng. Đây là một relay nhỏ, một tệp Python không có phụ thuộc, chuyển từng thông điệp tới mcp.fxsocket.com với khóa của bạn. Các công cụ và dữ liệu của bạn vẫn đến từ FxSocket, nên image không bao giờ cần cập nhật khi công cụ thay đổi. Được phát hành cho amd64 và arm64.

FXSOCKET_API_KEY=fxs_ro_xxx docker run -i --rm -e FXSOCKET_API_KEY fxsocket/mcp

Docker Hub · Mã nguồn trên GitHub (MIT)

Chi tiết giao thức

• Truyền tải: Streamable HTTP, chỉ POST, phản hồi JSON. Không trạng thái, không có phiên cần duy trì.
• Phiên bản giao thức: 2026-07-28 (siêu dữ liệu theo từng yêu cầu, không bắt tay) và 2025-03-26 đến 2025-11-25 (bắt tay initialize).
• Xác thực: cùng các khóa API như platform API, trong X-API-Key hoặc Authorization: Bearer.
• Chưa được hỗ trợ: các connector web trong claude.ai và ChatGPT, vốn đăng nhập bằng OAuth thay vì header. Claude Desktop hiện hoạt động qua Docker image.