GMO Coin FX MCP Server

gmocoin-mcp

<!-- mcp-name: io.github.RikitoNoto/gmocoin-fx-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

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