기록하기 전에 검토하기
현재 summary를 먼저 확인합니다. ledger record는 financial data이므로 중복 항목은 누락된 항목보다 판단하기 어렵습니다.
ledger({ action: "summary", months: 1 })공개 MCP 도구
ledger
목적
Ledger dispatcher를 통해 관리되는 financial transaction과 external-service renewal reminder를 구조화된 summary 및 audit 경계와 함께 관리합니다.
사용 시점
- amount, currency, date 및 merchant context가 있는 expense 또는 지원되는 transaction을 기록합니다.
- date, category, currency 또는 project filter로 승인된 Ledger record를 list, summarize 또는 overview합니다.
- subscription renewal reminder를 만들거나 관리하고 선택적으로 review cycle을 TODO에 연결합니다.
사용하지 않을 시점
- financial record에 generic remember를 사용하지 않습니다. transaction과 reminder에는 ledger가 financial data contract를 보존합니다.
- cross-currency total을 추정하지 않습니다. 안전하지 않은 aggregation은 summary에서 currency를 분리합니다.
- 필요한 exact ID/version과 user authorization 없이 record를 update하거나 delete하지 않습니다.
- REST API는 public MCP tool보다 넓은 field set을 허용합니다. scope, bucket, team 및 provenance filter는 /docs/api/memory를 참조합니다.
필수 스코프
- read action에는 memory:read가 필요하고 public chat surface의 transaction 및 subscription mutation에는 memory:write가 필요합니다.
- 인증된 owner/team/scope 경계가 모든 Ledger record와 reminder operation을 관리합니다.
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
action | add_expense | list | summary | overview | update_transaction · 필수 | caller가 선택하는 Ledger operation이며 이 다섯 가지 literal value만 허용됩니다. |
item / amount / transaction_type / currency | string / number | 핵심 transaction field이며 financial write에는 amount와 currency가 필요합니다. |
transaction_date / category / merchant / payment_method / note | string | 선택적 transaction 분류, 날짜 및 note field입니다. |
query / date_from / date_to / min_amount / max_amount | string / number | list 및 summary filter입니다. |
transaction_id / expected_version / patch | string / integer / object | 정확한 update target, optimistic concurrency version 및 허용되는 update field입니다. |
owner_timezone / project_id | string | 날짜 해석과 authorized project/team boundary입니다. |
limit / offset / months | integer / boolean · 기본값: 20 / 0 / 6 / false | pagination, summary horizon 및 structured-output control입니다. |
반환 스키마
요청한 transaction, summary group 또는 overview와 user-facing text summary가 structured output에 포함됩니다. Widget caller는 refresh metadata를 받을 수 있으며 raw secret은 response contract에 포함되지 않습니다.
예제
ledger({
action: "add_expense",
item: "Domain renewal",
amount: 18.00,
currency: "USD",
transaction_date: "2026-08-21",
category: "software"
})ledger({ action: "summary", months: 1 })오류
- Authorization failure: token에 read 권한을 위한 memory:read 또는 mutation을 위한 memory:write가 없습니다.
- Validation failure: 필수 transaction field, date format, currency 또는 action value가 유효하지 않습니다.
- Concurrency failure: update의 expected_version이 오래되었거나 exact transaction을 찾을 수 없습니다.
- Aggregation boundary: 서로 다른 currency의 record는 잘못된 combined total을 만들지 않고 별도로 보고됩니다.
관련 도구
출처: MCP reference