initial commit

한국투자증권(API)/MCP/Kis Trading MCP/configs/auth.json

@@ -0,0 +1,105 @@
+{
+  "tool_info": {
+    "introduce": "한국투자증권의 auth OPEN API를 활용합니다.",
+    "introduce_append": "",
+    "examples": [
+      {
+        "api_type": "auth_token",
+        "params": {
+          "grant_type": "client_credentials",
+          "env_dv": "real"
+        }
+      },
+      {
+        "api_type": "auth_ws_token",
+        "params": {
+          "grant_type": "client_credentials",
+          "env_dv": "real"
+        }
+      }
+    ]
+  },
+  "apis": {
+    "auth_token": {
+      "category": "OAuth인증",
+      "name": "접근토큰발급(P)",
+      "github_url": "https://github.com/koreainvestment/open-trading-api/tree/main/examples_llm/auth/auth_token",
+      "method": "auth_token",
+      "api_path": "/oauth2/tokenP",
+      "params": {
+        "grant_type": {
+          "name": "grant_type",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 권한부여 Type (client_credentials)"
+        },
+        "appkey": {
+          "name": "appkey",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 앱키 (한국투자증권 홈페이지에서 발급받은 appkey)"
+        },
+        "appsecret": {
+          "name": "appsecret",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 앱시크릿키 (한국투자증권 홈페이지에서 발급받은 appsecret)"
+        },
+        "env_dv": {
+          "name": "env_dv",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 환경구분 (real: 실전, demo: 모의)"
+        }
+      }
+    },
+    "auth_ws_token": {
+      "category": "OAuth인증",
+      "name": "실시간 (웹소켓) 접속키 발급",
+      "github_url": "https://github.com/koreainvestment/open-trading-api/tree/main/examples_llm/auth/auth_ws_token",
+      "method": "auth_ws_token",
+      "api_path": "/oauth2/Approval",
+      "params": {
+        "grant_type": {
+          "name": "grant_type",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 권한부여 Type (client_credentials)"
+        },
+        "appkey": {
+          "name": "appkey",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 고객 앱Key (한국투자증권 홈페이지에서 발급받은 appkey)"
+        },
+        "appsecret": {
+          "name": "appsecret",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 고객 앱Secret (한국투자증권 홈페이지에서 발급받은 appsecret)"
+        },
+        "env_dv": {
+          "name": "env_dv",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 환경구분 (real: 실전, demo: 모의)"
+        },
+        "token": {
+          "name": "token",
+          "type": "str",
+          "required": false,
+          "default_value": "",
+          "description": "접근토큰 (OAuth 토큰이 필요한 API 경우 발급한 Access token)"
+        }
+      }
+    }
+  }
+}

한국투자증권(API)/MCP/Kis Trading MCP/configs/elw.json

@@ -0,0 +1,172 @@
+{
+  "tool_info": {
+    "introduce": "한국투자증권의 ELW OPEN API를 활용합니다.",
+    "introduce_append": "이 도구는 ELW 관련 시세 정보를 제공합니다.",
+    "examples": [
+      {
+        "api_type": "volume_rank",
+        "params": {
+          "fid_cond_mrkt_div_code": "W",
+          "fid_cond_scr_div_code": "20278",
+          "fid_unas_input_iscd": "000000",
+          "fid_input_iscd": "00000",
+          "fid_input_rmnn_dynu_1": "",
+          "fid_div_cls_code": "0",
+          "fid_input_price_1": "1000",
+          "fid_input_price_2": "5000",
+          "fid_input_vol_1": "100",
+          "fid_input_vol_2": "1000",
+          "fid_input_date_1": "20230101",
+          "fid_rank_sort_cls_code": "0",
+          "fid_blng_cls_code": "0",
+          "fid_input_iscd_2": "0000",
+          "fid_input_date_2": ""
+        }
+      }
+    ]
+  },
+  "apis": {
+    "volume_rank": {
+      "category": "[국내주식] ELW시세",
+      "name": "ELW 거래량순위",
+      "github_url": "https://github.com/koreainvestment/open-trading-api/tree/main/examples_llm/elw/volume_rank",
+      "method": "volume_rank",
+      "api_path": "/uapi/elw/v1/ranking/volume-rank",
+      "params": {
+        "fid_cond_mrkt_div_code": {
+          "name": "fid_cond_mrkt_div_code",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "조건시장분류코드"
+        },
+        "fid_cond_scr_div_code": {
+          "name": "fid_cond_scr_div_code",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "조건화면분류코드"
+        },
+        "fid_unas_input_iscd": {
+          "name": "fid_unas_input_iscd",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "기초자산입력종목코드"
+        },
+        "fid_input_iscd": {
+          "name": "fid_input_iscd",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "발행사"
+        },
+        "fid_input_rmnn_dynu_1": {
+          "name": "fid_input_rmnn_dynu_1",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "입력잔존일수"
+        },
+        "fid_div_cls_code": {
+          "name": "fid_div_cls_code",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "콜풋구분코드"
+        },
+        "fid_input_price_1": {
+          "name": "fid_input_price_1",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "가격(이상)"
+        },
+        "fid_input_price_2": {
+          "name": "fid_input_price_2",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "가격(이하)"
+        },
+        "fid_input_vol_1": {
+          "name": "fid_input_vol_1",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "거래량(이상)"
+        },
+        "fid_input_vol_2": {
+          "name": "fid_input_vol_2",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "거래량(이하)"
+        },
+        "fid_input_date_1": {
+          "name": "fid_input_date_1",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "조회기준일"
+        },
+        "fid_rank_sort_cls_code": {
+          "name": "fid_rank_sort_cls_code",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "순위정렬구분코드"
+        },
+        "fid_blng_cls_code": {
+          "name": "fid_blng_cls_code",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "소속구분코드"
+        },
+        "fid_input_iscd_2": {
+          "name": "fid_input_iscd_2",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "LP발행사"
+        },
+        "fid_input_date_2": {
+          "name": "fid_input_date_2",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "만기일-최종거래일조회"
+        },
+        "tr_cont": {
+          "name": "tr_cont",
+          "type": "str",
+          "required": true,
+          "default_value": "",
+          "description": "연속 거래 여부"
+        },
+        "dataframe": {
+          "name": "dataframe",
+          "type": "pd.DataFrame",
+          "required": false,
+          "default_value": null,
+          "description": "누적 데이터프레임"
+        },
+        "depth": {
+          "name": "depth",
+          "type": "int",
+          "required": true,
+          "default_value": 0,
+          "description": "현재 재귀 깊이"
+        },
+        "max_depth": {
+          "name": "max_depth",
+          "type": "int",
+          "required": true,
+          "default_value": 10,
+          "description": "최대 재귀 깊이 (기본값: 10)"
+        }
+      }
+    }
+  }
+}

한국투자증권(API)/MCP/Kis Trading MCP/configs/etfetn.json

@@ -0,0 +1,70 @@
+{
+  "tool_info": {
+    "introduce": "한국투자증권의 ETF/ETN OPEN API를 활용합니다.",
+    "introduce_append": "",
+    "examples": [
+      {
+        "api_type": "inquire_price",
+        "params": {
+          "fid_cond_mrkt_div_code": "J",
+          "fid_input_iscd": "123456"
+        }
+      },
+      {
+        "api_type": "nav_comparison_trend",
+        "params": {
+          "fid_cond_mrkt_div_code": "J",
+          "fid_input_iscd": "069500"
+        }
+      }
+    ]
+  },
+  "apis": {
+    "inquire_price": {
+      "category": "[국내주식] 기본시세",
+      "name": "ETF/ETN 현재가",
+      "github_url": "https://github.com/koreainvestment/open-trading-api/tree/main/examples_llm/etfetn/inquire_price",
+      "method": "inquire_price",
+      "api_path": "/uapi/etfetn/v1/quotations/inquire-price",
+      "params": {
+        "fid_cond_mrkt_div_code": {
+          "name": "fid_cond_mrkt_div_code",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 조건 시장 분류 코드 (ex. J:KRX, NX:NXT, UN:통합)"
+        },
+        "fid_input_iscd": {
+          "name": "fid_input_iscd",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 입력 종목코드 (ex. 123456)"
+        }
+      }
+    },
+    "nav_comparison_trend": {
+      "category": "[국내주식] 기본시세",
+      "name": "NAV 비교추이(종목)",
+      "github_url": "https://github.com/koreainvestment/open-trading-api/tree/main/examples_llm/etfetn/nav_comparison_trend",
+      "method": "nav_comparison_trend",
+      "api_path": "/uapi/etfetn/v1/quotations/nav-comparison-trend",
+      "params": {
+        "fid_cond_mrkt_div_code": {
+          "name": "fid_cond_mrkt_div_code",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 조건 시장 분류 코드 (ex. J)"
+        },
+        "fid_input_iscd": {
+          "name": "fid_input_iscd",
+          "type": "str",
+          "required": true,
+          "default_value": null,
+          "description": "[필수] 입력 종목코드"
+        }
+      }
+    }
+  }
+}