kakao-moment-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GCP_PROJECT_ID | No | Google Cloud project ID for Firestore OAuth state persistence | |
| KAKAO_AUTH_MODE | No | Authentication mode: 'oauth' for hosted multi-user, 'session' for local/stdio (default 'session') | session |
| KAKAO_REDIRECT_URI | Yes | Redirect URI registered in the app | |
| KAKAO_REST_API_KEY | Yes | OAuth client_id for token issuance | |
| KAKAO_BUSINESS_CLIENT_SECRET | Yes | Business authentication client secret for token issuance | |
| KAKAO_OAUTH_FIRESTORE_DATABASE | No | Firestore database ID for OAuth state persistence |
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
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| loginA | 비즈니스 토큰으로 로그인 — tokeninfo 검증 후 서버 세션에 저장. 이후 툴은 토큰 인자 없이 호출. |
| use_accountA | 이후 조회의 기본 대상 광고계정을 세션에 설정. |
| logoutA | 세션의 로그인/계정 정보를 지운다. |
| session_statusA | 현재 인증 상태(로그인 여부·token_user_id·선택된 계정). 토큰 값은 노출 안 함. OAuth 로그인-온-커넥트 모드면 요청의 OAuth 토큰 컨텍스트를 보고(=실제 인증 경로), 아니면 세션 저장소(login 툴/웹 로그인)를 본다. |
| get_token_infoB | 비즈니스 토큰의 소유자(token_user_id)·접근 가능 광고계정 (GET kapi.kakao.com/v1/business/tokeninfo). |
| get_user_infoC | 비즈니스 토큰 사용자 정보 (GET /v1/business/userinfo). |
| list_ad_accountsA | 토큰이 접근 가능한 광고계정 전체 목록 (GET /adAccounts/pages, 전 페이지 순회). |
| get_ad_accountB | 광고계정 상세 (GET /adAccounts/{adAccountId}). |
| get_account_balanceB | 광고계정 실시간 잔액 (GET /adAccounts/balance). |
| list_trackersA | 픽셀 & SDK(트래커) 목록 (GET /adAccounts/trackers). |
| list_channel_profilesB | 카카오톡 채널 프로필 목록 (GET /adAccounts/channel/profiles). |
| list_campaignsB | 캠페인 목록 (GET /campaigns). |
| get_campaignA | 단일 캠페인 상세 (GET /campaigns/{id}). |
| list_adgroupsC | 광고그룹 목록 (GET /adGroups). |
| get_adgroupB | 단일 광고그룹 상세 (GET /adGroups/{id}). |
| list_creativesC | 소재 목록 (GET /creatives). |
| get_creativeB | 단일 소재 상세 (GET /creatives/{id}). |
| get_account_performanceB | 광고계정 성과 리포트 (GET /adAccounts/report). ID 불필요. |
| get_campaign_performanceA | 캠페인별 성과 리포트 (GET /campaigns/report). campaignId 필수 — 미지정 시 계정의 전체 캠페인을 자동 열거해 조회한다. |
| get_adgroup_performanceB | 광고그룹별 성과 리포트 (GET /adGroups/report). adGroupId 필수 — 미지정 시 (선택적 campaign_id 범위의) 광고그룹을 자동 열거. |
| get_creative_performanceA | 소재별 성과 리포트 (GET /creatives/report). creativeId 필수 — 미지정 시 (선택적 adgroup_id 범위의) 소재를 자동 열거. |
| get_performance_reportB | 레벨 지정 통합 성과 리포트. 인사이트 도출용 1급 툴. 하위 레벨은 계정 내 전체 엔티티를 자동 열거. |
| list_audiencesB | 오디언스 목록 (GET /targetings/audiences). |
| list_cohortsC | 광고반응타겟(cohort) 목록 (GET /targetings/cohort/list). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| metric_glossary | 지표 필드명 → (별칭, 설명) 사전. |
| report_dimensions | 리포트 집계 레벨/지표그룹/분해축 참고표. |