meritz-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | Host for HTTP mode. Default is '127.0.0.1'. | 127.0.0.1 |
| MCP_PATH | No | Path for HTTP mode. Default is '/mcp'. Use a random string as access token. | /mcp |
| MCP_PORT | No | Port for HTTP mode. Default is '8000'. | 8000 |
| MCP_TYPE | No | Transport type. Use 'streamable-http' for HTTP mode (e.g., for tunneling). Default is 'stdio'. | stdio |
| MERITZ_WS_URL | No | WebSocket URL for realtime data. Should be set if MERITZ_BASE_URL is not the production domain. | |
| MERITZ_APP_KEY | Yes | App key issued from the developer portal (https://openapi.imeritz.com). Required for API access. | |
| MERITZ_TIMEOUT | No | Request timeout in seconds. Default is '15'. | 15 |
| MERITZ_BASE_URL | No | Base URL for API calls. Defaults to the production domain. | https://openapi.imeritz.com |
| MERITZ_READ_ONLY | No | Whether to operate in read-only mode. Default is '1'; set to '0' to allow trading and currency exchange. | 1 |
| MERITZ_APP_SECRET | Yes | App secret issued from the developer portal. Required for API access. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| meritz_accountA | 메리츠 Open API — 계좌 (12건). api_type 으로 호출할 API 를 고르고 params 에 파라미터를 넣습니다. api_type='describe' 로 부르면 파라미터 설명을 돌려줍니다. collateral GET 내 계좌 담보 현황 조회 deposit GET 내 계좌 예수금 상세 조회 holdings GET 내 계좌 종목별 평가 조회 ovs_currencies GET 해외주식 외화잔고 조회 ovs_holdings GET 해외주식 잔고 조회 ovs_profit_loss GET 해외주식 실현손익 profit_loss GET 국내주식 실현손익 (일자별) profit_loss_summary GET 국내주식 실현손익 (합계) profit_loss_symbols GET 국내주식 실현손익 (종목별) transactions GET 내 계좌 입출금 내역 조회 valuation GET 내 계좌 자산평가 조회 valuation_by_asset GET 내 계좌 자산별 평가금액 조회 |
| meritz_marketA | 메리츠 Open API — 국내 시세(주식·지수) (13건). api_type 으로 호출할 API 를 고르고 params 에 파라미터를 넣습니다. api_type='describe' 로 부르면 파라미터 설명을 돌려줍니다. ★ 국내 일봉(market_candles_days)은 기본이 KRX 정규장 종가입니다 (mrkt_div_code 를 생략하면 'TJ'). market_candles_days GET 시세추이 조회(일봉) market_candles_minutes GET 시세추이 조회(분봉) market_index_candles_days GET 국내지수 시세추이 조회 market_index_candles_minutes GET 국내지수 시세추이 조회 (분봉) market_index_prices GET 국내지수 현재가 조회 market_investors GET 종목별 투자자매매동향 market_investors_detail GET 종목별 투자자매매동향 상세 market_orderbook GET 호가 조회 market_orderbook_after GET 시간외 단일가 호가 조회 market_prices GET 현재가 조회 market_prices_after GET 시간외 단일가 조회 market_trades_minutes GET 체결추이 조회(분) market_trades_ticks GET 체결추이 조회(틱) |
| meritz_overseas_marketA | 메리츠 Open API — 해외 시세(주식·지수·원자재·환율) (13건). api_type 으로 호출할 API 를 고르고 params 에 파라미터를 넣습니다. api_type='describe' 로 부르면 파라미터 설명을 돌려줍니다. ovs_market_candles_days GET 해외주식 시세추이 조회 (일봉) ovs_market_candles_minutes GET 해외주식 시세추이 조회 (분봉) ovs_market_commodities_prices GET 해외 원자재·달러인덱스 현재가 조회 ovs_market_fx_prices GET 환율 시세 조회 ovs_market_index_candles_days GET 해외지수 시세추이 조회 ovs_market_index_candles_minutes GET 해외지수 시세추이 조회(분봉) ovs_market_index_prices GET 해외지수 현재가 조회 ovs_market_orderbook GET 해외주식 호가 조회 ovs_market_prices GET 해외주식 현재가 조회 ovs_market_prices_after GET 해외주식 애프터장 현재가 조회 ovs_market_prices_daytime GET 해외주식 주간거래 현재가 조회 ovs_market_trades_minutes GET 해외주식 체결추이 조회 (분) ovs_market_trades_ticks GET 해외주식 체결추이 (틱) |
| meritz_tradingA | 메리츠 Open API — 주문 (24건). api_type 으로 호출할 API 를 고르고 params 에 파라미터를 넣습니다. api_type='describe' 로 부르면 파라미터 설명을 돌려줍니다. credit_orders_buy POST 신용매수 주문 ⚠ 상태변경 credit_orders_sell POST 신용매도 주문 ⚠ 상태변경 orders_buy POST 일반주문 매수 ⚠ 상태변경 orders_cancel POST 국내주식 주문 취소 ⚠ 상태변경 orders_estimate GET 주문가능금액·수량 조회 orders_history GET 주문내역 조회 orders_modify POST 국내주식 주문 정정 ⚠ 상태변경 orders_sell POST 일반주문 매도 ⚠ 상태변경 ovs_orders_buy POST 해외주식 매수 주문 ⚠ 상태변경 ovs_orders_cancel POST 해외주식 주문 취소 ⚠ 상태변경 ovs_orders_detail GET 해외주식 주문체결 상세조회 ovs_orders_estimate GET 해외주식 주문가능금액 조회 ovs_orders_history GET 해외주식 주문체결내역 조회 ovs_orders_modify POST 해외주식 주문 정정 ⚠ 상태변경 ovs_orders_sell POST 해외주식 매도 주문 ⚠ 상태변경 ovs_orders_today GET 해외주식 당일 주문체결내역 조회 ovs_reserved_orders GET 해외주식 예약주문 조회 ovs_reserved_orders_buy POST 해외주식 예약주문 매수 ⚠ 상태변경 ovs_reserved_orders_cancel POST 해외주식 예약주문 취소 ⚠ 상태변경 ovs_reserved_orders_sell POST 해외주식 예약주문 매도 ⚠ 상태변경 reserved_orders GET 국내주식 예약주문 조회 reserved_orders_buy POST 국내주식 예약주문 매수 ⚠ 상태변경 reserved_orders_cancel POST 국내주식 예약주문 취소 ⚠ 상태변경 reserved_orders_sell POST 국내주식 예약주문 매도 ⚠ 상태변경 |
| meritz_forexA | 메리츠 Open API — 환전 (4건). api_type 으로 호출할 API 를 고르고 params 에 파라미터를 넣습니다. api_type='describe' 로 부르면 파라미터 설명을 돌려줍니다. fx_exchanges POST 실시간 환전신청 ⚠ 상태변경 fx_exchanges_history GET 환전 내역 조회 fx_rates GET 고시환율 조회 fx_rates_applied GET 환전 적용환율 조회 |
| meritz_referenceA | 메리츠 Open API — 기준정보 (5건). api_type 으로 호출할 API 를 고르고 params 에 파라미터를 넣습니다. api_type='describe' 로 부르면 파라미터 설명을 돌려줍니다. ref_market_days GET 국내 영업일 조회 ref_market_hours GET 국내 장운영 조회 ref_ovs_exchanges GET 해외 거래소 조회 ref_ovs_market_days GET 해외 영업일 조회 ref_ovs_market_hours GET 해외 장운영 조회 |
| meritz_infoA | 서버 설정과 API 카탈로그 요약, 알려진 문제를 돌려줍니다. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
The seven top-level tools map cleanly to distinct domains: account, domestic market, overseas market, forex, reference data, trading, and server info. Although each tool internally dispatches many api_type operations, the domain boundaries between tools are unambiguous, so an agent can reliably choose the right tool family.
Every tool follows the same meritz_<domain> naming convention, and the internal api_type operation names use a consistent snake_case style with predictable prefixes (market_, ovs_, fx_, ref_, orders_, reserved_orders_). The convention is uniform across the set, even though it is noun-based rather than verb_noun.
Seven top-level tools is a reasonable, well-scoped surface. However, the aggregation is heavy: meritz_trading alone exposes 24 api_type operations, and several other tools expose 12–13 each, so the effective operation count is very large for a small number of dispatcher tools.
The surface covers account balances, holdings, transactions, domestic and overseas quotes/candles/orderbooks/trades, forex rates and exchanges, reference calendars/sessions, and a full domestic/overseas order lifecycle including buy, sell, cancel, modify, and reserved orders. No obvious operational gaps are apparent for a brokerage API wrapper.