nhplug MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NHPLUG_APP_KEY | Yes | NH Investment & Securities Open API app key (issued from the NHPLUG portal). | |
| NHPLUG_AUTH_URL | No | Authentication/token issuance URL. Usually left unchanged. | https://api.nhplug.com:8443 |
| NHPLUG_BASE_URL | No | REST base URL for API calls. Default is the live production URL. Use the mock trading URL for simulation/testing. | https://api.nhplug.com:8443 |
| NHPLUG_APP_SECRET | Yes | NH Investment & Securities Open API app secret (issued from the NHPLUG portal). | |
| NHPLUG_ALLOW_HOSTS | No | Comma-separated additional allowed hosts, e.g. for internal validation servers. Usually not set. | |
| NHPLUG_ENABLE_TRADING | No | Set to true only to expose trading/order tools. Default false. | false |
| NHPLUG_DEFAULT_ACCOUNT | No | Default account number used by balance/order shortcut tools when an account number is omitted. |
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_apisA | NH투자증권 Open API 에서 호출 가능한 엔드포인트 목록을 조회합니다. 자산군(domain)·카테고리·키워드로 필터링할 수 있습니다. 먼저 이 도구로 원하는 API 의 operationId 를 찾은 뒤 describe_api / call_api 로 이어가세요. 주문(거래) API 는 서버가 거래 활성화 모드일 때만 표시됩니다. |
| describe_apiA | 특정 operationId 의 입력 필드(Input_0) 스키마를 반환합니다. call_api 호출 전에 어떤 파라미터가 필요한지 확인하는 용도입니다. |
| call_apiA | operationId 와 입력값으로 NH Open API 를 실제 호출합니다. 인증/헤더/Input_0 봉투는 자동 처리됩니다. 주문(거래) API 는 서버가 거래 활성화 모드(NHPLUG_ENABLE_TRADING=true)일 때만 호출됩니다. |
| get_stock_priceA | 국내주식 현재가 시세를 조회합니다. (단축 도구 = call_api 로 krstockQuoteCurrentPrice 를 호출하는 것과 동일) |
| get_stock_balanceA | 국내주식 계좌 잔고를 조회합니다. (단축 도구 = krstockInquiryBalance) |
| list_accountsA | 로그인 자격증명(앱키/시크릿)에 연결된 보유 계좌 목록을 조회합니다. 잔고조회·주문 전에 계좌번호(act_no)를 확보하는 용도입니다. 입력값은 없습니다. (플랫폼 공통 엔드포인트 POST /n2/acctinfo) |
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 6 tools
The generic list_apis/describe_api/call_api trio is clearly separated by role, but get_stock_price and get_stock_balance are explicit duplicates of call_api (the descriptions literally say they equal calling krstockQuoteCurrentPrice / krstockInquiryBalance), so an agent faces two valid paths for the same result. The descriptions do explain the shortcut relationship, which keeps it from being worse than moderate overlap.
All six tools follow a clean snake_case verb_noun pattern: list_apis, describe_api, call_api, get_stock_price, get_stock_balance, list_accounts. Names are predictable and immediately readable.
Six tools is well-scoped: a discovery/describe/invoke meta-layer plus a handful of convenience wrappers and an account lookup. Nothing feels padded relative to the goal of exposing an external API catalog with trading gated behind a flag.
list_apis + describe_api + call_api provides universal coverage of every NH Open API endpoint, with list_accounts supplying the prerequisite act_no for balance/order flows. Minor gap: shortcut coverage is asymmetric (only price and balance, no order or other asset-class shortcuts), but call_api serves as an escape hatch so no workflow is truly blocked.