How do I use gmocoin-fx-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@gmocoin-fx-mcp place a market buy order for 1000 USD/JPY" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

gmocoin-fx-mcp

by RikitoNoto

Overview Schema Source Related Servers Discussions Admin

Python

Remote

gmocoin-mcp

MCP client registration

Register the server with an MCP client by using either stdio or HTTP. The local checkout example below uses /path/to/gmocoin-fx-mcp; replace it with the absolute path to this repository.

Recommended: Docker image from GHCR

The recommended setup is to run the published Docker image from GitHub Container Registry over stdio. Add the following entry to your MCP client configuration:

{
  "mcpServers": {
    "gmocoin-fx": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "GMO_API_KEY",
        "--env",
        "GMO_SECRET_KEY",
        "--env",
        "ORDER_SIZE_LIMIT",
        "--env",
        "ORDER_SYMBOL_LIMITS",
        "--env",
        "ORDER_CLIENT_ORDER_ID_PREFIX",
        "ghcr.io/rikitonoto/gmocoin-fx-mcp:latest"
      ],
      "env": {
        "GMO_API_KEY": "your-api-key",
        "GMO_SECRET_KEY": "your-secret-key",
        "ORDER_SIZE_LIMIT": "10000",
        "ORDER_SYMBOL_LIMITS": "USD_JPY,EUR_JPY",
        "ORDER_CLIENT_ORDER_ID_PREFIX": "mcp"
      }
    }
  }
}

Only GMO_API_KEY and GMO_SECRET_KEY are required. Remove optional environment variables when you do not need order-size, symbol, or client-order-id limits. The --env options pass those values from the MCP client process into the Docker container. Do not set MCP_TRANSPORT for stdio; the server uses stdio by default. The -i option is required because the MCP client communicates with the container over standard input/output.

Local source checkout

Use this setup when you want to run the server from a local checkout instead of the published image:

{
  "mcpServers": {
    "gmocoin-fx": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/gmocoin-fx-mcp",
        "run",
        "src/main.py"
      ],
      "env": {
        "GMO_API_KEY": "your-api-key",
        "GMO_SECRET_KEY": "your-secret-key",
        "ORDER_SIZE_LIMIT": "10000",
        "ORDER_SYMBOL_LIMITS": "USD_JPY,EUR_JPY",
        "ORDER_CLIENT_ORDER_ID_PREFIX": "mcp"
      }
    }
  }
}

HTTP

Use HTTP when your MCP client supports remote or URL-based servers. Start the server:

docker run --rm \
  --env MCP_TRANSPORT=http \
  --env MCP_HTTP_HOST=0.0.0.0 \
  --env MCP_HTTP_PORT=8000 \
  --env MCP_HTTP_PATH=/mcp \
  --env GMO_API_KEY=your-api-key \
  --env GMO_SECRET_KEY=your-secret-key \
  -p 8000:8000 \
  ghcr.io/rikitonoto/gmocoin-fx-mcp:latest

Then register the server URL in your MCP client:

http://localhost:8000/mcp

Related MCP server: XBTFX MCP Trading Server

Environment variables

Name	Required	Description
`GMO_API_KEY`	Yes	GMO Coin FX API key.
`GMO_SECRET_KEY`	Yes	GMO Coin FX secret key.
`ORDER_SIZE_LIMIT`	No	Maximum order size accepted by the `order_api`, `close_order_api`, `ifd_order_api`, and `ifdoco_order_api` tools.
`ORDER_SYMBOL_LIMITS`	No	Comma-separated list of symbols accepted by the `order_api`, `close_order_api`, `ifd_order_api`, `ifdoco_order_api`, and `cancel_bulk_order_api` tools.
`ORDER_CLIENT_ORDER_ID_PREFIX`	No	ASCII alphanumeric prefix used to auto-generate `client_order_id` for `order_api`, `close_order_api`, `ifd_order_api`, and `ifdoco_order_api` calls and to filter `active_orders_api`, `latest_executions_api`, and `open_positions_api` results. Must be 22 characters or fewer. The server appends a 14-digit timestamp suffix (`yyyyMMddHHmmss`) so the resulting ID stays within GMO Coin FX's 36-character limit.
`MCP_TRANSPORT`	No	MCP transport to use. Defaults to `stdio`; set to `http` to listen over HTTP. `sse` and `streamable-http` are also accepted.
`MCP_HTTP_HOST`	No	Host/interface for HTTP transports. Defaults to `0.0.0.0`.
`MCP_HTTP_PORT`	No	Port for HTTP transports. Defaults to `8000`.
`MCP_HTTP_PATH`	No	Optional endpoint path for HTTP transports, such as `/mcp`.

Running over HTTP

The server still starts with the standard stdio MCP transport by default:

uv run src/main.py

To expose the MCP server over HTTP, set MCP_TRANSPORT=http before starting it:

MCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_HTTP_PORT=8000 uv run src/main.py

When running with Docker Compose, the compose file loads .env but does not force a transport. Leave MCP_TRANSPORT unset to use stdio, or set MCP_TRANSPORT=http in .env to use the published port 8000.

Tools

Name	Description
`order_api`	Places a new GMO Coin FX order.
`close_order_api`	Places a GMO Coin FX close order. Supports optional `size` or `settle_position` parameters.
`ifd_order_api`	Places a GMO Coin FX IFD order using `symbol`, `client_order_id`, `first_side`, `first_execution_type`, `first_size`, `first_price`, `second_execution_type`, `second_size`, and `second_price`.
`ifdoco_order_api`	Places a GMO Coin FX IFDOCO order using `symbol`, `client_order_id`, `first_side`, `first_execution_type`, `first_size`, `first_price`, `second_size`, `second_limit_price`, and `second_stop_price`.
`change_ifdoco_order_api`	Changes prices for an existing GMO Coin FX IFDOCO order. Specify exactly one of `root_order_id` or `client_order_id`, plus at least one of `first_price`, `second_limit_price`, or `second_stop_price`.
`change_ifd_order_api`	Changes prices for an existing GMO Coin FX IFD order. Specify exactly one of `root_order_id` or `client_order_id`, plus at least one of `first_price` or `second_price`.
`change_oco_order_api`	Changes limit/stop prices for an existing GMO Coin FX OCO order.
`change_order_api`	Changes the price of a GMO Coin FX normal order. Specify exactly one of `order_id` or `client_order_id`, plus `price`.
`cancel_orders_api`	Cancels up to 10 GMO Coin FX orders at once. Specify exactly one of `root_order_ids` or `client_order_ids`.
`cancel_bulk_order_api`	Cancels GMO Coin FX orders in bulk by required `symbols` and optional `side` and `settle_type`. When `ORDER_SYMBOL_LIMITS` is configured, every requested symbol must be allowed.
`active_orders_api`	Retrieves active GMO Coin FX orders. Supports optional `symbol`, `prev_id`, and `count` parameters. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, only active orders whose `client_order_id` starts with that prefix are returned.
`latest_executions_api`	Retrieves the latest GMO Coin FX executions for a required `symbol` and optional `count`. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, only executions whose `client_order_id` starts with that prefix are returned.
`open_positions_api`	Retrieves all GMO Coin FX open positions. Supports an optional `symbol` parameter. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, latest executions are used to return only positions whose opening `client_order_id` starts with that prefix.

Resources

URI	Description
`gmocoin-fx://account/assets`	Retrieves GMO Coin FX account asset balances as JSON. Asset balances are exposed as an MCP resource because they are read-only account state with a stable URI and no invocation parameters.

Available Tools

14 tools

active_orders_apiC

GMO Coin FXの有効注文一覧を取得します。

Name	Required	Description	Default
`count`	No
`symbol`	No
`prev_id`	No

Output Schema

Name	Required	Description
`result`	Yes

cancel_bulk_order_apiC

GMO Coin FXの注文を銘柄などの条件で一括キャンセルします。

Name	Required	Description	Default
`side`	No
`symbols`	Yes
`settle_type`	No

Output Schema

Name	Required	Description
No output parameters

cancel_orders_apiC

GMO Coin FXの注文を最大10件までまとめてキャンセルします。

Name	Required	Description	Default
`root_order_ids`	No
`client_order_ids`	No

Output Schema

Name	Required	Description
No output parameters

change_ifdoco_order_apiC

GMO Coin FXのIFDOCO注文を変更します。

Name	Required	Description	Default
`first_price`	No
`root_order_id`	No
`client_order_id`	No
`second_stop_price`	No
`second_limit_price`	No

Output Schema

Name	Required	Description
`result`	Yes

change_ifd_order_apiC

GMO Coin FXのIFD注文を変更します。

Name	Required	Description	Default
`first_price`	No
`second_price`	No
`root_order_id`	No
`client_order_id`	No

Output Schema

Name	Required	Description
`result`	Yes

change_oco_order_apiC

GMO Coin FXのOCO注文変更を実行します。

Name	Required	Description	Default
`stop_price`	No
`limit_price`	No
`root_order_id`	No
`client_order_id`	No

Output Schema

Name	Required	Description
No output parameters

change_order_apiC

GMO Coin FXの通常注文価格を変更します。

Name	Required	Description	Default
`price`	Yes
`order_id`	No
`client_order_id`	No

Output Schema

Name	Required	Description
`result`	Yes

close_order_apiC

GMO Coin FXの決済注文を実行します。

Name	Required	Description
`side`	Yes	売買区分 BUY: 売 SELL: 買
`size`	No
`symbol`	Yes	銘柄
`stop_price`	No
`limit_price`	No
`lower_bound`	No
`upper_bound`	No
`execution_type`	Yes	注文タイプ
`client_order_id`	No
`settle_position`	No

Output Schema

Name	Required	Description
`result`	Yes

ifdoco_order_apiC

GMO Coin FXのIFDOCO注文を実行します。

Name	Required	Description	Default
`symbol`	No
`first_side`	No
`first_size`	No
`first_price`	No
`second_size`	No
`client_order_id`	No
`second_stop_price`	No
`second_limit_price`	No
`first_execution_type`	No

Output Schema

Name	Required	Description
`result`	Yes

ifd_order_apiC

GMO Coin FXのIFD注文を実行します。

Name	Required	Description	Default
`symbol`	No
`first_side`	No
`first_size`	No
`first_price`	No
`second_size`	No
`second_price`	No
`client_order_id`	No
`first_execution_type`	No
`second_execution_type`	No

Output Schema

Name	Required	Description
`result`	Yes

kline_apiA

GMO Coin FXのKline APIです。ローソク足、OHLC、価格履歴、為替レート履歴、チャート用の時系列データを取得します。price_typeは必須です（BID/ASK）。dateはYYYY-MM-DD形式で指定してください。

Name	Required	Description
`date`	Yes
`symbol`	Yes	銘柄
`interval`	Yes
`price_type`	Yes

Output Schema

Name	Required	Description
`result`	Yes

latest_executions_apiB

GMO Coin FXの最新約定一覧を取得します。

Name	Required	Description	Default
`count`	No
`symbol`	Yes	銘柄

Output Schema

Name	Required	Description
`result`	Yes

open_positions_apiB

GMO Coin FXの建玉一覧を取得します。

Name	Required	Description	Default
`symbol`	No

Output Schema

Name	Required	Description
`result`	Yes

order_apiC

GMO Coin FXの新規注文を実行します。

Name	Required	Description
`side`	Yes	売買区分 BUY: 売 SELL: 買
`size`	Yes
`symbol`	Yes	銘柄
`stop_price`	No
`limit_price`	No
`lower_bound`	No
`upper_bound`	No
`execution_type`	Yes	注文タイプ
`client_order_id`	No

Output Schema

Name	Required	Description
`result`	Yes

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

14 tool updatesv1.0.1Jul 28, 2026
- First observedactive_orders_api
- First observedcancel_bulk_order_api
- First observedcancel_orders_api
- First observedchange_ifd_order_api
- First observedchange_ifdoco_order_api
- First observedchange_oco_order_api
- First observedchange_order_api
- First observedclose_order_api
- First observedifd_order_api
- First observedifdoco_order_api
- First observedkline_api
- First observedlatest_executions_api
- First observedopen_positions_api
- First observedorder_api

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3/5.0

Scored 2026-07-28 16:35 across 14 tools

Disambiguation4/5

Most tools have clear distinct purposes (cancel, change, order types, market data). However, there is potential confusion between cancel_orders_api and cancel_bulk_order_api, and the absence of an OCO creation tool alongside change_oco_order_api may cause ambiguity.

Naming Consistency3/5

Tool names are mostly snake_case and share the '_api' suffix, but there are inconsistencies: 'kline_api' uses a noun instead of verb_noun, and while most tools follow 'verb_noun', some like 'active_orders_api' use adjective_noun. The naming pattern is not uniformly applied.

Tool Count5/5

With 14 tools covering order management, market data, and position tracking, the number is well-suited for an FX trading server. It's neither too sparse nor overly complex.

Completeness4/5

The tool set covers core trading operations (orders, modifications, cancellations, market data, positions). However, the lack of an OCO order creation tool is a notable gap, and there is no specific order detail retrieval tool beyond listing active orders.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

AutoviewA
com.autoview
Place and inspect orders on your own exchange accounts from an MCP-connected agent.
Finance Cryptocurrency
191
https://api.autoview.com/mcp/
crypto-mcp-serverA
com.thenextgennexus
Live cryptocurrency prices and FX rates as agent tools.
Cryptocurrency Finance
2
https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/crypto-mcp-server/mcp
AlgoVesta MCP Trading
com.algovesta
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
Cryptocurrency Finance
24
https://api.algovesta.com/mcp
OpenFinance — Easy Trading: Crypto, Stocks, Perps & Prediction MarketsA
tech.openfinance
OpenFinance gives any AI agent easy trading across every major market through one hosted MCP server. Trade crypto spot and perpetuals on Hyperliquid with market, limit and TWAP orders, leverage and margin control. Trade stocks, indices, commodities, forex and pre-IPO names as Hyperliquid HIP-3 perps. Trade Polymarket prediction markets with odds, order books, positions, PnL and trader leaderboards. Swap and bridge across 40+ EVM chains and Solana with Relay and Jupiter, find memecoins across 200+ chains, launch tokens on Robinhood Chain and Solana, and buy crypto with card, bank or UPI. Write actions are designed to ask for your confirmation first. Connect with OAuth (sign in to OpenFinance and approve) or an API key. Works with Claude, ChatGPT, Cursor, VS Code, Codex and any MCP client. No install. Home: https://openfinance.tech/agents · Docs: https://docs.openfinance.tech · GitHub: https://github.com/openfinance-tech/mcp
Autonomous Agents Cryptocurrency Finance
181
https://api.openfinance.tech/agent/mcp

Related MCP Servers

Alpaca Trading MCP Server
Finance Autonomous Agents
dogmaai
A
license
Not graded
quality
F
maintenance
Enables natural language trading operations through Alpaca's API, supporting stocks, options, crypto, portfolio management, and real-time market data with comprehensive order execution and account management capabilities.
Updated a year ago (2025-12-05 15:46 UTC)
MIT
XBTFX MCP Trading Server
Finance Cryptocurrency Agent Orchestration
XBTFX
A
license
A
quality
C
maintenance
Enables AI agents to trade forex, metals, indices, and cryptocurrencies via the Model Context Protocol using the XBTFX Trading API. It provides comprehensive tools for managing account balances, retrieving market data, and executing trade operations like opening, modifying, or closing positions.
Updated a month ago (2026-09-25 13:21 UTC)
15
15 npm
MIT
MetaTrader MCP Server
Finance Research & Data
joangrcia
A
license
Not graded
quality
C
maintenance
Enables AI assistants to trade on MetaTrader 5 using natural language, supporting account management, order placement, and real-time market data.
Updated 5 months ago (2026-06-19 22:13 UTC)
1
MIT
ReadyTrader-FOREX
Finance Autonomous Agents
up2itnow0822
A
license
Not graded
quality
B
maintenance
Enables AI agents to perform forex trading operations through brokerages with risk controls and safety guardrails.
Updated 3 days ago (2026-11-06 16:39 UTC)
MIT

gmocoin-mcp

MCP client registration

Recommended: Docker image from GHCR

Local source checkout

HTTP

Environment variables

Running over HTTP

Tools

Resources

Available Tools

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Alpaca Trading MCP Server

XBTFX MCP Trading Server

MetaTrader MCP Server

ReadyTrader-FOREX