# 키움 REST API Docs MCP

키움증권 REST TR 스펙(`kiwoom-rest-api-spec.json`)을 **조회만** 하는 MCP입니다.  
한투 `kis-code-assistant` MCP와 같은 역할(문서 검색)이며, **실제 API 호출·주문·토큰 발급은 하지 않습니다.**

## Tools

| Tool | 용도 |
|------|------|
| `kiwoom_api_stats` | API 수·카테고리 분포 |
| `search_kiwoom_api` | 이름/설명/필드 키워드 검색 |
| `get_kiwoom_api` | apiId 상세(requestIo/responseIo/예제) |
| `list_kiwoom_apis` | prefix·category·url 필터 목록 |
| `lookup_kiwoom_error` | 에러코드 조회 |

## Cursor 등록

프로젝트 `.cursor/mcp.json`에 `kiwoom-docs`로 등록되어 있습니다.

```bash
# 수동 실행(스모크)
cd /home/hoon/kis_bot/mcp/kiwoom-docs-mcp
uv sync
uv run python server.py --stdio
```

## 데이터

- `data/kiwoom-rest-api-spec.json` — 키움 TR 카탈로그 (OpenAPI 아님)