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:

config.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:

config.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:

Terminal

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.