예금 + 신용
입출금, 저축, 신용카드 데이터를 위한 9가지 도구예요. 대부분의 사용자가 가장 오래 머무는 영역이에요.
list_accounts
연결된 모든 계좌의 잔액과 유형을 보여줘요.
“지금 각 계좌에 얼마나 들어 있나요?”
get_account
ID로 단일 계좌의 상세 정보를 조회해요. 보통 list_accounts 뒤에 이어서 호출해요.
“입출금 계좌에 대해 더 알려 주세요. 정식 명칭, 뒷자리, 유형이요.”
list_transactions
주력 도구예요. 날짜, 금액, 카테고리, 계좌로 필터링하고 페이지네이션도 가능해요. 대부분의 질문이 이 도구로 처리돼요.
“이번 달 100달러에서 500달러 사이의 결제를 전부 보여 주세요.”
search_transactions
가맹점 이름에 대한 부분 문자열 매칭이에요. 이름의 일부는 알지만 카테고리가 잘못됐을 수 있을 때 써요.
“가맹점 이름에 'coffee'가 들어간 거래를 모두 찾아 주세요.”
get_spending_summary
카테고리, 가맹점, 월, 주 단위로 지출을 묶어 줘요. 정렬된 버킷을 반환해요.
“3월 지출을 가맹점별로 상위 10곳까지 나눠 주세요.”
get_recurring_charges
패턴으로 감지한 구독과 공과금이에요. 비슷한 가맹점 + 비슷한 금액 + 비슷한 주기를 찾아요.
“제 반복 결제 목록을 전부 알려 주세요.”
get_monthly_cashflow
특정 달의 수입 대 지출과 상위 수입원 + 카테고리를 알려 줘요. 한 번 호출, 한 달치.
“2026년 3월의 현금흐름을 보여 주세요. 상위 지출 카테고리도 포함해서요.”
get_merchant_history
한 가맹점의 모든 결제 내역이에요. 'X에 얼마나 썼지?' 같은 질문에 딱이에요.
“올해 Whole Foods에서의 모든 결제와 월별 합계를 보여 주세요.”
list_categories
내 데이터에 존재하는 고유 카테고리 목록이에요. '어떤 카테고리가 있는지'부터 살펴볼 때 유용해요.
“제 데이터에 어떤 지출 카테고리가 나타나나요?”
투자
증권 데이터를 위한 두 가지 도구예요. 보유 자산(스냅샷)과 거래 내역(히스토리)이에요.
list_holdings
원가 대비 손익을 포함한 현재 보유 종목이에요.
“제가 보유한 모든 종목을 현재 가치 순으로 정렬해서 손익까지 보여 주세요.”
list_investment_transactions
매수, 매도, 배당, 수수료를 담아요. 날짜, 계좌, 유형으로 필터링할 수 있어요.
“최근 90일간의 모든 배당금 지급 내역을 알려 주세요.”
연결
에이전트가 새로운 은행 연결이 필요하다고 판단할 때 쓰는 도구 하나예요.
connect_bank
은행 연결 플로우를 여는 URL을 반환해요. list_accounts가 아무 연결도 반환하지 않거나 사용자가 은행 추가를 요청할 때 사용해요.
“다른 은행을 연결하고 싶어요. 어떻게 하면 되나요?”