FIXSIM

io.github.GammaThreeTrading由 GitHub 帳號 GammaThreeTrading 發布v0.1.2更新於 Oct 24, 2026

Test FIX from Claude, ChatGPT, or Cursor: free sandbox FIX sessions or your own FIXSIM instances.

已驗證Streamable HTTP可網頁執行金融開發者工具

概覽

AI 產生的概覽

FIXSIM 的託管 MCP 伺服器,讓助理建立 FIX 測試工作階段、檢視 FIX 訊息與訂單,並模擬交易所回報。

可以做什麼
  • 建立、檢視與結束免費的匿名沙箱 FIX 工作階段,含連線資訊與到期時間
  • 查詢沙箱連線狀態,讀取 FIX 訊息記錄、活動訂單與工作階段設定
  • 在沙箱中扮演交易所:成交、部分成交、拒絕或取消訂單,或開啟自動成交
  • 列出 FIXSIM 執行個體、工作階段、證券、進出方向訂單與執行報告
  • 對送入 FIXSIM 的訂單執行確認、成交、拒絕、取消、到期、重述等動作,並向外送出訂單或取消
  • 在工作階段上送出任意原始 FIX 應用訊息
適用情境
適合在測試 FIX 交易引擎或下單流程時使用:直接在聊天用戶端操作工作階段、檢視原始 FIX 訊息並模擬對手方回應,不必另開工具。
執行需求
遠端 Streamable HTTP 端點,不需本機執行環境。sandbox_ 工具不需帳號或金鑰;fixsim_ 工具需以 x-api-key 標頭提供 FIXSIM API 金鑰,並具備對應執行個體的權限。自行架設需 .NET 8。
安裝前請注意
fixsim_ 工具會送出真實 FIX 訊息並改變 FIXSIM 執行個體上的訂單狀態,若只需檢視請改用唯讀端點。API 金鑰會在每次呼叫時轉送給 FIXSIM。沙箱工作階段為匿名且有上限(4 小時、每日 100 則應用訊息)。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 FIXSIM,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.GammaThreeTrading%2Ffixsim/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "fixsim": {
      "type": "http",
      "url": "https://mcp.fixsim.com/mcp"
    }
  }
}

README

fixsim-mcp

An MCP server for FIXSIM, the hosted FIX protocol simulator. Add it to Claude, Cursor, VS Code, or ChatGPT and test FIX from a conversation:

"Create a FIX 4.4 test session for me, then tell me when my engine has logged on and show me the first order it sent."

Two tool families live on one endpoint:

ToolsWhoAuth
sandbox_*anyonenone. Free, anonymous, 4-hour sessions on the Developer Sandbox
fixsim_*FIXSIM customersyour FIXSIM API key, sent as an x-api-key header

Connect

Hosted endpoint: https://mcp.fixsim.com/mcp (read-only variant: https://mcp.fixsim.com/mcp/readonly).

Claude Code

bash
claude mcp add --transport http fixsim https://mcp.fixsim.com/mcp --header "x-api-key: YOUR_FIXSIM_API_KEY"

Leave off --header if you only want the free sandbox tools.

Cursor / VS Code (mcp.json)

json
{  "mcpServers": {    "fixsim": {      "url": "https://mcp.fixsim.com/mcp",      "headers": { "x-api-key": "YOUR_FIXSIM_API_KEY" }    }  }}

Claude.ai / Claude Desktop: Customize → Connectors → Add custom connector → URL https://mcp.fixsim.com/mcp. Choose authentication None for the sandbox. To use your own instances, add a request header x-api-key (header support in the connector dialog is rolling out; if you do not see it, use Claude Code or Cursor for now).

Tools

Sandbox (no auth)

ToolWhat it does
sandbox_create_sessionProvision a free FIX session. Returns host, port, SenderCompID (your tag 49), TargetCompID (tag 56), BeginString, expiry.
sandbox_get_statusIs your engine connected? connected / waiting / disabled.
sandbox_get_messagesThe FIX message log, raw and parsed. Pass afterSeq to poll for new messages.
sandbox_get_ordersWorking orders your engine sent in.
sandbox_act_on_orderPlay the exchange: fill, partial, reject, cancel.
sandbox_set_autofillFill every incoming order automatically.
sandbox_get_sessionRe-fetch the connection card.
sandbox_end_sessionEnd the session early.

Sandbox limits: 100 application messages per session per day, 4-hour sessions, a handful of sessions per caller.

FIXSIM instances (API key)

ToolWhat it does
fixsim_list_instancesInstances your key can access. Start here.
fixsim_list_sessions, fixsim_get_sessionSessions on an instance: FIX version, CompIDs, role, logged-in state, sequence numbers.
fixsim_list_orders_in, fixsim_get_order_inOrders your system sent into FIXSIM, with raw FIX and audit trail.
fixsim_list_executions_outExecution reports FIXSIM sent you (acks, fills, rejects). Filter by ClOrdID.
fixsim_list_orders_out, fixsim_list_executions_inThe reverse direction, when FIXSIM is the order sender.
fixsim_list_securitiesSymbols and prices on an instance.
fixsim_act_on_ordersAck, fill, partially fill, reject, cancel, expire… orders your system sent in.
fixsim_send_orderHave FIXSIM send you a New Order Single.
fixsim_cancel_order_outHave FIXSIM cancel an order it sent.
fixsim_send_raw_fixSend any raw FIX message on a session.

The /mcp/readonly endpoint exposes the same tools but refuses the ones that send.

Every fixsim_* call is checked against the instances your key is entitled to, and is rate-limited per key (120 calls per minute by default).

Run it yourself

Requires .NET 8.

bash
dotnet run --project src/FixSim.Mcp --urls http://localhost:5199

Configuration (appsettings.json or environment variables such as FixSim__BaseUrl):

KeyDefaultMeaning
FixSim:BaseUrlhttps://portal.fixsim.com/The FIXSIM site whose /v1 API the fixsim_* tools call
FixSim:PerKeyCallsPerMinute120Per-key rate limit at this server
Sandbox:EnabledtrueRegister the sandbox_* tools
Sandbox:BaseUrlhttps://sandbox.fixsim.com/The Developer Sandbox web app
Sandbox:CallerKeyemptyShared secret sent as X-Sandbox-Caller so the sandbox can trust server-to-server calls

The server is stateless (Streamable HTTP), so it scales horizontally behind any load balancer.

How it works

The server is a thin client. fixsim_* tools call the public FIXSIM REST API (/v1/...) with your key; sandbox_* tools call the Developer Sandbox's session API. Nothing is stored here beyond a one-minute cache of which instances a key may access. Your API key is forwarded to FIXSIM on each call and never logged.

License

MIT

來源:README.md,提交 5c8b2fe

工具

21

fixsim_list_orders_out

List outbound orders

Orders FIXSIM sent OUT on a session (created with fixsim_send_order). Pass clOrdId to fetch one.

輸入參數limitapiKeyclOrdIdsession必填instance必填

sandbox_get_status

Check sandbox connection status

Is the user's FIX engine connected to the sandbox session? Returns state: connected, waiting (nobody logged on yet), disabled, or unknown.

輸入參數sessionId必填

fixsim_send_order

Send a New Order Single

Have FIXSIM send a New Order Single (35=D) OUT on a session to the user's system, so they can test how their system handles inbound orders. Follow up with fixsim_list_orders_out and fixsim_list_executions_in to see what came back.

輸入參數side必填priceapiKeysymbol必填clOrdId必填ordType必填session必填instance必填orderQty必填additionalTags

fixsim_list_orders_in

List inbound orders

Orders the user's trading system sent INTO FIXSIM on a session (FIXSIM is the counterparty). Includes ClOrdID, symbol, side, quantity, remaining quantity, order status and the raw FIX message. Optionally filter by FIX OrdStatus code (tag 39): 0 new, 1 partially filled, 2 filled, 4 canceled, 8 rejected.

輸入參數limitapiKeysession必填instance必填orderStatus

fixsim_list_executions_in

List inbound execution reports

Execution reports the user's system sent INTO FIXSIM on a session (when FIXSIM is the order sender and the user's system is the executing side). Optionally filter by ExecID (tag 17).

輸入參數limitapiKeyexecIdsession必填instance必填

fixsim_act_on_orders

Act on inbound orders

Respond to orders the user's system sent into FIXSIM: acknowledge, fully or partially execute, reject, cancel remaining, expire, done-for-day, restate, or accept/reject a pending cancel/replace. FIXSIM emits the matching execution reports on the FIX session. Give one or more ClOrdIDs; for executions supply lastPx and, for a partial, lastQty.

輸入參數action必填apiKeylastPxlastQtysession必填clOrdIds必填instance必填

sandbox_set_autofill

Set sandbox auto-fill

Turn automatic fills on or off for a sandbox session. On: every order the user sends is filled immediately at the security's last price. Off (default): orders are acknowledged and wait for sandbox_act_on_order.

輸入參數enabled必填sessionId必填

fixsim_cancel_order_out

Send an Order Cancel Request

Have FIXSIM send an Order Cancel Request (35=F) for an order it previously sent out with fixsim_send_order.

輸入參數apiKeyclOrdId必填session必填instance必填newClOrdIdadditionalTags

fixsim_list_sessions

List FIX sessions

List the FIX sessions on an instance with their FIX version, CompIDs, acceptor/initiator role, host/port, enabled and logged-in state, and sequence numbers.

輸入參數apiKeyinstance必填

fixsim_list_executions_out

List outbound execution reports

Execution reports FIXSIM sent OUT on a session (acks, fills, partial fills, rejects, cancels). Pass clOrdId to see the full execution history of one order: ExecType, OrdStatus, LastPx/LastQty, CumQty, LeavesQty, AvgPx and the raw FIX.

輸入參數limitapiKeyclOrdIdsession必填instance必填

fixsim_get_session

Get FIX session

Get one FIX session's settings and live state (logged in?, sequence numbers, connection details).

輸入參數apiKeysession必填instance必填

sandbox_act_on_order

Fill, reject, or cancel a sandbox order

Play the exchange for one order the user sent in: fill (full execution), partial (partial fill), reject, or cancel (cancel the remaining quantity). FIXSIM sends the matching execution report back to the user's engine.

輸入參數action必填clOrdId必填sessionId必填

fixsim_get_order_in

Get inbound order

Get one inbound order by ClOrdID (tag 11), including its raw FIX message and audit trail. Use this to explain why an order was rejected or what state it is in.

輸入參數apiKeyclOrdId必填session必填instance必填

sandbox_get_orders

List sandbox orders

Working orders the user's engine has sent into the sandbox session: ClOrdID, symbol, side, qty, filled, leaves, price, status.

輸入參數sessionId必填

sandbox_get_messages

Read sandbox FIX message log

The FIX message log for a sandbox session, oldest first: logons, heartbeats, orders in, execution reports out, rejects. Each message has seq, timeUtc, inbound (true = user's engine sent it), msgType, raw FIX, and parsed tag/value fields. Pass afterSeq (the last seq you saw) to fetch only new messages. Use this to explain what happened on the wire.

輸入參數afterSeqsessionId必填

sandbox_create_session

Create sandbox FIX session

Create a free, anonymous FIX test session on the FIXSIM Developer Sandbox. No account or API key needed. Returns the connection card: host, port, the SenderCompID the user must put in tag 49, the TargetCompID for tag 56, BeginString, and the expiry (sessions last 4 hours, cap 100 application messages per day). The user's FIX engine connects as the initiator; FIXSIM is the acceptor and acknowledges every order. Keep the returned id; every other sandbox tool needs it.

輸入參數fixVersion

sandbox_end_session

End sandbox session

End a sandbox session now instead of waiting for it to expire. Frees the slot for the user's IP.

輸入參數sessionId必填

fixsim_send_raw_fix

Send raw FIX messages

Send one or more raw FIX application messages OUT on a session as given (tag=value pairs separated by | or SOH). FIXSIM supplies the session header fields (BeginString, CompIDs, MsgSeqNum, SendingTime) and the checksum. Use for message types the other tools do not cover.

輸入參數apiKeysession必填instance必填fixMessages必填

fixsim_list_instances

List FIXSIM instances

List the FIXSIM instances your API key can access. An instance is a hosted FIX engine; each holds one or more FIX sessions. Start here to learn the instance names other tools need.

輸入參數apiKey

fixsim_list_securities

List securities

Securities (symbol, last price, CUSIP, ISIN) configured on an instance. FIXSIM prices fills from these.

輸入參數apiKeyinstance必填

sandbox_get_session

Get sandbox session

Re-fetch a sandbox session's connection card by id, including whether auto-fill is on and when it expires.

輸入參數sessionId必填

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分