Kakao Moment MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KAKAO_MCP_LOG_DIR | No | Log directory | ~/.kakao-moment-mcp/logs |
| KAKAO_OAUTH_SCOPES | No | OAuth scopes (optional) | |
| KAKAO_REDIRECT_URI | No | OAuth redirect URI | http://localhost:8765/callback |
| KAKAO_REST_API_KEY | Yes | Kakao REST API key (required) | |
| KAKAO_AD_ACCOUNT_ID | Yes | Kakao ad account ID (number as string, required) | |
| KAKAO_CLIENT_SECRET | Yes | Kakao client secret (required) | |
| KAKAO_MCP_LOG_LEVEL | No | Log level | INFO |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_ad_account_infoA | 카카오모먼트 광고계정 정보(이름, 상태, 사업자, 잔액부족 여부 등)를 조회합니다. 이런 질문에 사용하세요: • "광고계정 상태 어때?" / "광고계정 정보 보여줘" • "지금 광고계정 잘 돌아가고 있어?" • "광고계정에 문제 있어?" / "잔액부족 상태야?" • "내 광고계정 ID/이름 뭐였지?" |
| get_bizmoneyA | 비즈머니 잔액 + 최근 7일 소진 추이 + 현재 페이스 기준 잔여 일수 예상. 이런 질문에 사용하세요: • "비즈머니 얼마 남았어?" / "잔액 얼마야?" / "광고비 얼마 남았어?" • "이대로 가면 며칠 더 쓸 수 있어?" / "비즈머니 며칠치 남았어?" • "최근 일주일 광고비 얼마 썼어?" • "비즈머니 충전해야 해?" / "잔액 부족하지 않아?" |
| list_campaignsA | 전체 캠페인 목록(이름·상태·일예산·캠페인 타입) 조회. 이런 질문에 사용하세요: • "캠페인 목록 보여줘" / "어떤 캠페인 돌고 있어?" • "지금 켜져 있는 캠페인만 알려줘" → status_filter="ON" • "꺼져 있는 캠페인" / "OFF 상태 캠페인" → status_filter="OFF" • "캠페인 ID 뭐였지?" / "캠페인 일예산 얼마야?" Args: status_filter: ON / OFF / DELETED 등의 상태 필터 (선택) with_details: True(기본) 면 캠페인별 detail 을 함께 조회해 일예산/타입을 채움. 캠페인이 많아 느릴 때 False 로 끄세요. |
| list_adgroupsA | 특정 캠페인 내 광고그룹 목록(입찰가·일예산·집행기간·디바이스) 조회. 이런 질문에 사용하세요: • "캠페인 X 의 광고그룹 보여줘" / "X 안에 어떤 그룹 있어?" • "광고그룹 입찰가 얼마야?" / "그룹 일예산 얼마로 잡혀있어?" • "그룹 집행기간 언제까지야?" ⚠️ 광고그룹 ID 만 알고 캠페인 ID 모르면, 먼저 list_campaigns 로 캠페인을 찾으세요. Args: campaign_id: 특정 캠페인의 광고그룹만 조회 (필수에 가까움) with_details: True(기본) 면 광고그룹별 detail 로 입찰가/일예산/기간 보강. |
| list_creativesA | 특정 광고그룹의 소재 목록(포맷·심사상태·미리보기·랜딩URL·제목/설명) 조회. 이런 질문에 사용하세요: • "광고그룹 X 의 소재 보여줘" / "어떤 소재가 돌고 있어?" • "소재 심사상태 어떻게 돼?" / "반려된 소재 있어?" • "소재 미리보기 / 이미지 URL 줘" • "소재 랜딩 페이지 어디로 가?" ⚠️ 소재의 성과(클릭률/소진)는 get_performance_report(target="creative") 로 별도 조회. Args: adgroup_id: 특정 광고그룹의 소재만 조회 (필수에 가까움) with_details: True(기본) 면 소재별 detail 로 포맷/심사상태/이미지 보강. |
| get_performance_reportA | 기간별 성과 리포트(노출·클릭·비용·전환·CTR·CPC·ROAS). 이런 질문에 사용하세요 (예시 → 인자): • "어제 성과 요약해줘" → target="account", date_from/date_to=어제 • "어제 캠페인별 성과" → target="campaign", date_from/date_to=어제 • "지난주 광고그룹별 성과" → target="adgroup", date_from/date_to=지난주 월~일 • "최근 7일 ROAS 좋은 광고그룹" → target="adgroup", 최근 7일 • "캠페인 X 의 어제 성과" → target="campaign", target_id="X", 어제 • "어제 클릭률 낮은 소재" → target="creative", date_from/date_to=어제 • "지난주 대비 이번주 성과 변화" → 두 번 호출 후 비교 • "오늘 시간대별 페이스" → 단발이면 get_today_status 가 더 적합. • "디바이스별 / 지면별 성과" → breakdown="device" / "placement" Args: target: account | campaign | adgroup | creative date_from: YYYY-MM-DD (오늘 = today.isoformat()) date_to: YYYY-MM-DD target_id: campaign/adgroup/creative 일 때 특정 ID (선택). 전체 대상이면 비움. breakdown: day | hour | device | placement (선택) |
| get_today_statusA | 오늘 광고계정 상태: 누적 소진·시간당 페이스·마감 예상 소진율·노출/클릭·잔액. 이런 질문에 사용하세요: • "오늘 일예산 얼마나 썼어?" / "오늘 소진액 얼마야?" • "지금 페이스 어때?" / "이대로 가면 오늘 얼마 쓸 것 같아?" • "오늘 광고 잘 돌고 있어?" / "오늘 노출/클릭 어때?" • "오늘 마감 예상 소진율" / "현재 시간당 평균 얼마야?" ⚠️ 어제/지난주 같은 과거 기간은 get_performance_report 로. |
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
Each tool has a clearly distinct purpose: account info, balance, period performance, today's status, listing campaigns, ad groups, and creatives. No two tools overlap in functionality; even the performance tools are separated by time scope.
All tools follow a consistent 'verb_noun' pattern with 'get_' for singular queries and 'list_' for multiple items. The naming is predictable and intuitive.
With 7 tools, the server is well-scoped for querying Kakao Moment advertising data. Each tool addresses a key aspect, and the count is neither too sparse nor overwhelming.
The tool surface is entirely read-only—it provides queries for info, balance, performance, and listings, but lacks any create, update, or delete operations for campaigns, ad groups, or creatives. This limits its utility for full campaign management.