Skip to main content
Glama
gmocoin-fx-mcp

gmocoin-fx-mcp

by RikitoNoto

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.

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の有効注文一覧を取得します。

Inputs: count, symbol, prev_id. Returns: result

cancel_bulk_order_apiC

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

Inputs: symbols (required), side, settle_type. Returns: object

cancel_orders_apiC

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

Inputs: root_order_ids, client_order_ids. Returns: object

change_ifdoco_order_apiC

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

Inputs: first_price, root_order_id, client_order_id, second_stop_price, +1 more. Returns: result

change_ifd_order_apiC

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

Inputs: first_price, second_price, root_order_id, client_order_id. Returns: result

change_oco_order_apiC

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

Inputs: stop_price, limit_price, root_order_id, client_order_id. Returns: object

change_order_apiC

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

Inputs: price (required), order_id, client_order_id. Returns: result

close_order_apiC

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

Inputs: side (required), symbol (required), execution_type (required), size, +6 more. Returns: result

ifdoco_order_apiC

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

Inputs: symbol, first_side, first_size, first_price, +5 more. Returns: result

ifd_order_apiC

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

Inputs: symbol, first_side, first_size, first_price, +5 more. Returns: result

kline_apiA

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

Inputs: date (required), symbol (required), interval (required), price_type (required). Returns: result

latest_executions_apiB

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

Inputs: symbol (required), count. Returns: result

open_positions_apiB

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

Inputs: symbol. Returns: result

order_apiC

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

Inputs: side (required), size (required), symbol (required), execution_type (required), +5 more. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored 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

    Related MCP Connectors

    Related MCP Servers

    • 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.
      MIT
    • 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.
      15
      36 npm
      MIT
    • 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.
      1
      MIT