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 — 계좌 (11건). 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 내 계좌 자산평가 조회 |
| meritz_marketA | 메리츠 Open API — 국내주식 시세 (10건). api_type 으로 호출할 API 를 고르고 params 에 파라미터를 넣습니다. api_type='describe' 로 부르면 파라미터 설명을 돌려줍니다. market_candles_days GET 시세추이 조회(일봉) market_candles_minutes 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 — 해외주식 시세 (6건). api_type 으로 호출할 API 를 고르고 params 에 파라미터를 넣습니다. api_type='describe' 로 부르면 파라미터 설명을 돌려줍니다. ovs_market_candles_days GET 해외주식 시세추이 조회 (일봉) ovs_market_candles_minutes GET 해외주식 시세추이 조회 (분봉) ovs_market_orderbook GET 해외주식 호가 조회 ovs_market_prices 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 tools are partitioned by clear domains: account, market, overseas market, trading, forex, reference, and server info. There is little risk of selecting the wrong tool because each namespace maps to a distinct financial function, and even the adjacent market/overseas_market pair is clearly separated by the overseas prefix.
All tool names follow the same meritz_<domain> snake_case convention, and the nested api_type values are also uniformly snake_case. The naming pattern is predictable and consistent across the entire server.
Seven tools is well within the ideal 3-15 range and matches the server's intended scope: one namespace per major brokerage function plus an info tool. Although meritz_trading contains many sub-APIs, that is an internal detail rather than an MCP tool-count problem.
The surface covers account inquiries, domestic and overseas market data, the full order lifecycle, forex exchange, reference data, and a server-info/catalog tool. Common trading workflows have no dead ends, and the meritz_info tool aids discoverability of available operations.