{ "markdown": "# gmocoin-mcp\n\n\n\n## MCP client registration\n\nRegister the server with an MCP client by using either `stdio` or HTTP.\nThe local checkout example below uses `/path/to/gmocoin-fx-mcp`; replace it with the absolute path to this repository.\n\n### Recommended: Docker image from GHCR\n\nThe recommended setup is to run the published Docker image from GitHub Container Registry over `stdio`.\nAdd the following entry to your MCP client configuration:\n\n```json\n{\n \"mcpServers\": {\n \"gmocoin-fx\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"--env\",\n \"GMO_API_KEY\",\n \"--env\",\n \"GMO_SECRET_KEY\",\n \"--env\",\n \"ORDER_SIZE_LIMIT\",\n \"--env\",\n \"ORDER_SYMBOL_LIMITS\",\n \"--env\",\n \"ORDER_CLIENT_ORDER_ID_PREFIX\",\n \"ghcr.io/rikitonoto/gmocoin-fx-mcp:latest\"\n ],\n \"env\": {\n \"GMO_API_KEY\": \"your-api-key\",\n \"GMO_SECRET_KEY\": \"your-secret-key\",\n \"ORDER_SIZE_LIMIT\": \"10000\",\n \"ORDER_SYMBOL_LIMITS\": \"USD_JPY,EUR_JPY\",\n \"ORDER_CLIENT_ORDER_ID_PREFIX\": \"mcp\"\n }\n }\n }\n}\n```\n\nOnly `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.\nThe `--env` options pass those values from the MCP client process into the Docker container.\nDo not set `MCP_TRANSPORT` for `stdio`; the server uses `stdio` by default.\nThe `-i` option is required because the MCP client communicates with the container over standard input/output.\n\n### Local source checkout\n\nUse this setup when you want to run the server from a local checkout instead of the published image:\n\n```json\n{\n \"mcpServers\": {\n \"gmocoin-fx\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/path/to/gmocoin-fx-mcp\",\n \"run\",\n \"src/main.py\"\n ],\n \"env\": {\n \"GMO_API_KEY\": \"your-api-key\",\n \"GMO_SECRET_KEY\": \"your-secret-key\",\n \"ORDER_SIZE_LIMIT\": \"10000\",\n \"ORDER_SYMBOL_LIMITS\": \"USD_JPY,EUR_JPY\",\n \"ORDER_CLIENT_ORDER_ID_PREFIX\": \"mcp\"\n }\n }\n }\n}\n```\n\n### HTTP\n\nUse HTTP when your MCP client supports remote or URL-based servers.\nStart the server:\n\n```bash\ndocker run --rm \\\n --env MCP_TRANSPORT=http \\\n --env MCP_HTTP_HOST=0.0.0.0 \\\n --env MCP_HTTP_PORT=8000 \\\n --env MCP_HTTP_PATH=/mcp \\\n --env GMO_API_KEY=your-api-key \\\n --env GMO_SECRET_KEY=your-secret-key \\\n -p 8000:8000 \\\n ghcr.io/rikitonoto/gmocoin-fx-mcp:latest\n```\n\nThen register the server URL in your MCP client:\n\n```text\nhttp://localhost:8000/mcp\n```\n\n## Environment variables\n\n| Name | Required | Description |\n| --- | --- | --- |\n| `GMO_API_KEY` | Yes | GMO Coin FX API key. |\n| `GMO_SECRET_KEY` | Yes | GMO Coin FX secret key. |\n| `ORDER_SIZE_LIMIT` | No | Maximum order size accepted by the `order_api`, `close_order_api`, `ifd_order_api`, and `ifdoco_order_api` tools. |\n| `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. |\n| `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. |\n| `MCP_TRANSPORT` | No | MCP transport to use. Defaults to `stdio`; set to `http` to listen over HTTP. `sse` and `streamable-http` are also accepted. |\n| `MCP_HTTP_HOST` | No | Host/interface for HTTP transports. Defaults to `0.0.0.0`. |\n| `MCP_HTTP_PORT` | No | Port for HTTP transports. Defaults to `8000`. |\n| `MCP_HTTP_PATH` | No | Optional endpoint path for HTTP transports, such as `/mcp`. |\n\n## Running over HTTP\n\nThe server still starts with the standard stdio MCP transport by default:\n\n```bash\nuv run src/main.py\n```\n\nTo expose the MCP server over HTTP, set `MCP_TRANSPORT=http` before starting it:\n\n```bash\nMCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_HTTP_PORT=8000 uv run src/main.py\n```\n\nWhen 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`.\n\n## Tools\n\n| Name | Description |\n| --- | --- |\n| `order_api` | Places a new GMO Coin FX order. |\n| `close_order_api` | Places a GMO Coin FX close order. Supports optional `size` or `settle_position` parameters. |\n| `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`. |\n| `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`. |\n| `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`. |\n| `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`. |\n| `change_oco_order_api` | Changes limit/stop prices for an existing GMO Coin FX OCO order. |\n| `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`. |\n| `cancel_orders_api` | Cancels up to 10 GMO Coin FX orders at once. Specify exactly one of `root_order_ids` or `client_order_ids`. |\n| `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. |\n| `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. |\n| `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. |\n| `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. |\n\n\n## Resources\n\n| URI | Description |\n| --- | --- |\n| `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. |\n", "bytes": 7259, "sha": "d2281d08c46b25a52c042d92a12eabf582924d6e413517c5e5ca218a61cf133f", "repo_slug": "rikitonoto/gmocoin-fx-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_rikitonoto_gmocoin_fx_mcp_471f7fe9/readme" }