{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_bfn7gq75h89m","handle":"pykiwoom-mcp-server","url":"https://wellknown.network/agents/pykiwoom-mcp-server","links":{"self":"https://wellknown.network/agents/pykiwoom-mcp-server/record.json","html":"https://wellknown.network/agents/pykiwoom-mcp-server","markdown":"https://wellknown.network/agents/pykiwoom-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/pykiwoom-mcp-server","status":"https://wellknown.network/api/v1/agents/pykiwoom-mcp-server/status","claim":"https://wellknown.network/agents/pykiwoom-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/pykiwoom-mcp-server/claim.json","badge":"https://wellknown.network/agents/pykiwoom-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/pykiwoom-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/pykiwoom-mcp-server/tools"},"ard":{"identifier":"urn:air::server:pykiwoom-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"pykiwoom-mcp-server","summary":"PyKiwoom-REST용 MCP stdio 서버","description":"# PyKiwoom MCP 서버\n\n키움증권 REST API를 MCP 도구로 제공하는 stdio 서버입니다. 실제 구현은 메인 패키지의\n`pykiwoom_rest.mcp_server`에 있으며, 이 디렉터리는 기존 `pykiwoom-mcp-server` 설치 방식과\n실행 명령을 유지하는 호환 패키지입니다.\n\n## 동작 방식\n\n- `KiwoomRest`의 호출 가능한 공개 메서드를 시작 시 분석합니다.\n- 타입 힌트와 기본값으로 각 도구의 JSON Schema를 만듭니다.\n- `list_endpoints`로 전체 도구 또는 카테고리별 도구를 조회할 수 있습니다.\n- API 클라이언트는 실제 API 도구를 처음 호출할 때 생성됩니다.\n- 동기 REST 호출은 작업 스레드에서 실행되어 MCP 이벤트 루프를 막지 않습니다.\n- 날짜, 모델, DataFrame 계열 결과도 JSON으로 직렬화합니다.\n\n실시간 콜백 구독, 연결 종료, 내부 속도 제한 초기화처럼 stdio 요청/응답 모델에 맞지 않는\n메서드는 자동 도구에서 제외됩니다.\n\n## 요구 사항\n\n- Python 3.10 이상\n- `pykiwoom-rest` 2.2.0 이상\n- 안정 MCP Python SDK 1.x (`mcp>=1.27,<2`)\n\nMCP Python SDK 2.x가 정식 출시되기 전까지 예기치 않은 호환성 변경을 막기 위해 상한을 둡니다.\n\n## 설치\n\n메인 패키지의 추가 의존성으로 설치하는 방법을 권장합니다.\n\n```bash\npip install 'pykiwoom-rest[mcp]'\n```\n\n저장소 개발 버전은 다음과 같이 설치합니다.\n\n```bash\ngit clone https://github.com/unohee/pykiwoom-rest.git\ncd pykiwoom-rest\npip install -e '.[mcp]'\n```\n\n기존 호환 패키지만 별도로 설치할 수도 있습니다.\n\n```bash\ncd pykiwoom-mcp-server\npip install -e .\n```\n\n## 인증 정보\n\nMCP 클라이언트의 서버 환경 변수에 다음 값을 전달합니다.\n\n```bash\nACCOUNT_NO=your-account-number\nKIWOOM_APPKEY=your-app-key\nKIWOOM_APPSECRET=your-app-secret\n```\n\n실제 API 호출 전까지 클라이언트를 만들지 않으므로, 인증 정보 없이도 서버 초기화와\n`list_tools`, `list_endpoints`를 검사할 수 있습니다.\n\n## 실행\n\n```bash\n# 메인 패키지 명령\nkiwoom-mcp\n\n# 기존 호환 명령\npykiwoom-mcp-server\n```\n\n두 명령은 같은 서버 구현을 실행합니다. 로그는 `stderr`, MCP 프로토콜 메시지는 `stdio`로\n분리되므로 서버 실행 중 `stdout`에 임의 메시지를 출력하면 안 됩니다.\n\n## MCP 클라이언트 설정\n\n```json\n{\n  \"mcpServers\": {\n    \"pykiwoom\": {\n      \"command\": \"kiwoom-mcp\",\n      \"env\": {\n        \"ACCOUNT_NO\": \"your-account-number\",\n        \"KIWOOM_APPKEY\": \"your-app-key\",\n        \"KIWOOM_APPSECRET\": \"your-app-secret\"\n      }\n    }\n  }\n}\n```\n\n가상환경에 설치했다면 `command`에 해당 가상환경의 `kiwoom-mcp` 절대 경로를 지정하세요.\n\n## 도구 카테고리\n\n- `stock`: 종목 시세, 호가, 투자자·프로그램 동향\n- `chart`: 틱·분·일·주·월·년 차트\n- `account`: 잔고, 평가, 예수금, 체결·미체결\n- `order`: 매수, 매도, 정정, 취소\n- `ranking`: 거래량, 거래대금, 등락률 등 순위\n- `sector`: 업종 시세와 차트\n- `auth`: 토큰 상태, 갱신, 폐기\n- `etc`: 연결 확인과 기타 읽기 API\n\n`list_endpoints`의 `category…","publisher":null,"homepage":null,"repository":null,"version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp","kiwoom","stock","trading","api","korea"],"pricing":null,"endpoints":[{"url":"pypi:pykiwoom-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"pykiwoom-mcp-server","registry":"pypi","observedAt":"2026-11-03T22:25:46.652Z","publishedAt":"2026-07-19T08:17:26.903408Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"pykiwoom-mcp-server","url":"https://pypi.org/project/pykiwoom-mcp-server/","firstSeenAt":"2026-09-10T10:24:36.227Z","fetchedAt":"2026-11-03T22:25:04.292Z","normalizedAt":"2026-11-03T22:25:04.292Z"}]},"firstSeenAt":"2026-09-10T10:24:36.227Z","updatedAt":"2026-11-03T22:25:46.652Z"}