koynfx

KOYN FX is a remote MCP for TradeLocker-backed forex and CFD trading.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Get Trading Analysis: LRA + SMC trading analysis for a symbol (e.g. XAUUSD, BTCUSD, EURUSD). Requires OAuth (connected TradeLocker account) for live data. Read-only: never places a trade. Returns a te
  • Get Trading Analysis Result: Read a legacy analysis job by ID. New get_trading_analysis calls are self-contained and do not require this.
  • Ask Koyn: Ask the KOYN agent a general market question (news, macro, concepts). On timeout, returns an interim news/calendar snapshot you can share immediately.

What data it sees

Do you need an account

No: the server works without sign-in

KOYN FX is a remote MCP for TradeLocker-backed forex and CFD trading. Authenticate with KOYN OAuth, then analyze symbols with Smart Money Concept and Locked-In Range Analysis, check news and calendar, inspect account and positions, place orders, and run Auto Pilot with risk rails. Trading tools can submit live orders.

How to connect

How to connect koynfx to Claude

The server address to paste into Claude settings:

https://koynfx--koynlabs.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect koynfx to ChatGPT

The server address to paste into ChatGPT settings:

https://koynfx--koynlabs.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect koynfx to Cursor

The server address to paste into Cursor settings:

https://koynfx--koynlabs.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (22)

Raw names from tools/list. Only developers need these.

get_trading_analysisLRA + SMC trading analysis for a symbol (e.g. XAUUSD, BTCUSD, EURUSD). Requires OAuth (connected TradeLocker account) for live data. Read-only: never places a trade. Returns a terminal completed or degraded result with a 15m+1H candlestick image (when bars exist), quote provenance, LRA, deterministic SMC evidence, scenarios, timeframe/bar counts, news risk, and degradation reasons. Look at the image first. Pass ``timeframe`` from the Trading Terminal widget context when available (e.g. 1m, 15m, 1H). Omit only to use the user's last saved terminal selection — never default to 1H yourself.
get_trading_analysis_resultRead a legacy analysis job by ID. New get_trading_analysis calls are self-contained and do not require this.
ask_koynAsk the KOYN agent a general market question (news, macro, concepts). On timeout, returns an interim news/calendar snapshot you can share immediately.
get_market_newsLatest market news, optionally filtered by a symbol.
get_economic_calendarMedium/high-impact economic events. window is 'today' or 'this_week'.
get_symbol_quoteLive quote from the connected broker. Requires OAuth.
list_instrumentsList tradable symbols on the connected TradeLocker account, grouped by type. Requires OAuth. Use for 'list instruments', 'what can I trade', etc. asset_class filters: forex, crypto, metals, indices, commodities, equity. search is an optional symbol substring (e.g. 'XAU', 'BTC').
get_positionsOpen TradeLocker positions. Requires OAuth.
get_account_balanceAccount balance/equity plus Account widget settings (starting balance, risk limits, profit target). Requires OAuth.
get_open_ordersPending (non-final) orders. Requires OAuth.
get_trade_performanceTrade performance stats. Requires OAuth.
get_runtime_usageIncluded symbol-hours remaining, plan allocation, and metered-overage status. Requires OAuth.
set_metered_overageEnable or disable metered overage after included symbol-hours run out. Requires explicit user intent and OAuth. Starter/Pro only. When disabled with hours depleted, Auto Pilot may be force-stopped.
place_orderPlace a real order. side='buy'|'sell'; order_type='market'|'limit'|'stop'. Places a live TradeLocker order. Requires OAuth.
place_oco_ordersPlace OCO breakout orders. Requires OAuth.
modify_orderModify a pending order. Requires OAuth.
modify_positionModify SL, TP, or trailing stop on a live position. Requires explicit intent and OAuth.
cancel_orderCancel a pending order. Requires OAuth.
close_positionClose a position. Requires OAuth.
start_autonomous_tradingEnable autonomous trading for the given symbols and start workflows. symbols is a comma-separated string, e.g. 'XAUUSD' or 'XAUUSD,BTCUSD' (not a JSON array). mode is 'conservative' | 'balanced' | 'aggressive'. Requires OAuth. The autonomous engine may place live trades on its schedule.
stop_autonomous_tradingDisable autonomous trading. Requires OAuth.
get_autonomous_statusCurrent autonomous state. Requires OAuth.