io.github.RikitoNoto/gmocoin-fx-mcp

Official

by RikitoNoto · Python

GMO Coin FX MCP Server

MCP server for GMO Coin FX trading, positions, executions, klines, and account balances.

Trade FX, manage positions, and check account balances on GMO Coin.

README.md7 KBView on GitHub

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:

json

{
  "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:

json

{
  "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:

bash

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:

text

http://localhost:8000/mcp

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:

bash

uv run src/main.py

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

bash

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.

Install

Configuration

Environment variables

GMO_API_KEYrequiredsecret

GMO Coin FX API key.

GMO_SECRET_KEYrequiredsecret

GMO Coin FX secret key.

ORDER_SIZE_LIMIT

Optional maximum order size accepted by order-entry tools.

ORDER_SYMBOL_LIMITS

Optional comma-separated list of symbols accepted by order tools.

ORDER_CLIENT_ORDER_ID_PREFIX

Optional ASCII alphanumeric prefix for generated and filtered client order IDs.

claude_desktop_config.json

{
  "mcpServers": {
    "gmocoin-fx-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/rikitonoto/gmocoin-fx-mcp:1.0.1"
      ],
      "env": {
        "GMO_API_KEY": "<YOUR_GMO_API_KEY>",
        "GMO_SECRET_KEY": "<YOUR_GMO_SECRET_KEY>",
        "ORDER_SIZE_LIMIT": "<YOUR_ORDER_SIZE_LIMIT>",
        "ORDER_SYMBOL_LIMITS": "<YOUR_ORDER_SYMBOL_LIMITS>",
        "ORDER_CLIENT_ORDER_ID_PREFIX": "<YOUR_ORDER_CLIENT_ORDER_ID_PREFIX>"
      }
    }
  }
}