株主優待 MCP (Yutai MCP)
Japanese shareholder benefits search, cross-trading cost estimates, and trading date calculations.
| Endpoint | https://yutai-mcp.web.app/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.0 |
| Now | 4 tools · grade D (52) · pin ts_b5cc301f24451b5e4650fea54cb00d61 · protocol 2025-06-18 |
| First / last listed | 2026-10-26 07:07 UTC / 2026-10-26 07:07 UTC |
| Grade over time | 2026-10-26: D (52), 4 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: search_benefits get_benefit estimate_cross_fee calc_dates
search_benefits | 株主優待を検索する。複数条件を組み合わせて絞り込める。
【重要: vestingDates と karaDates の違い】
vestingDates(権利確定日): 現物保有で優待を得るための権利確定月日。「○月に権利確定する銘柄」はこちら。
karaDates(空クロス日): 権利確定日だけでなく別の日付にも株を一定数保有する必要がある銘柄の、その追加保有日。
端株保有だけでは条件を満たせず、その日付にクロス取引(空クロス)で株数を確保する必要がある。
「○月に空クロスが必要な銘柄」→ karaDate="MM" または karaDateFrom/karaDateTo で検索する。
vestingDate で検索しても空クロス対象の銘柄は正しく絞り込めない。
【信用取引区分 lendingType】
both=制度信用売り可。制度信用でクロスができる
buying_on params: keyword, benefitTypes, vestingDate, vestingDateFrom, vestingDateTo, requireKara, karaDate, karaDateFrom, karaDateTo, lendingType, sellProhibited, sellCaution, sellRestricted, longType, hasLongCondition, anyDay, minActualYield, maxActualYield, minValue, maxValue, minRequiredFunds, maxRequiredFunds, minPrevLendingInterest, maxPrevLendingInterest, minMarginRateMultiplier, maxMarginRateMultiplier, minRarity, maxRarity, updateFrom, updateTo, canNormalSelling_any, minRemain_any_count, canNormalSelling_sbi, canNormalSelling_gmo, canNormalSelling_rakuten, canNormalSelling_kabucom, canNormalSelling_smbc, minRemain_sbi, minRemain_gmo, minRemain_rakuten |
get_benefit | 銘柄コードで株主優待を1件取得する。sections で返す情報を選ぶ(不要なものは返さない)。
- basic (既定): 銘柄の基本情報。優待内容・権利確定日(vestingDates)・
空クロス日(karaDates)・信用区分(lendingType)・制度信用の規制状態(systemLendingStatus:
none/warn=注意喚起/prohibited=売禁)・増担保の最高料率倍率(marginRateMultiplier)・
長期条件・難易度・株価・必要資金・実質利回り(actualYield)・
現時点の一般信用残数(normalLendingStatus)・details(候補と長期保有条件)。
- negativeInterests: 逆日歩(制度信用売りで発生しうる、金額が事前に確定しない追加費用)の履歴。
prev(前回権利付最終日の params: code*, sections |
estimate_cross_fee | 株主優待クロス取引(現物買い+信用売りを同時に建てて優待だけ受け取る手法)の手数料を試算する。
【対象範囲】
・同一証券会社内で「買い」と「売り」の両方を建てるケースのみを計算する。証券会社をまたいだ
組み合わせ(例: 楽天で買ってカブコムで売る)は計算しない。
・buyMethod: 'spot'=現物買い(sbi/gmo/rakuten/kabucom) / 'system_margin_then_receipt'=制度信用買い+現引き(smbcのみ)
・sellMethod: 'general_short'=一般信用(短期) / 'general_long'=一般信用(無期限・長期) / 'system'=制度信用
ユーザーへの回答時はこれらの値をそのまま出さず、日本語(現物買い、制度信用買い+現引き、短期一般信用、
無期限一般信用、制度信用)に訳して説明すること。
params: code*, units, price, date, sbiVip, sbiZeroRevolution, gmoVip, rakutenCourse, rakutenVip, rakutenPreferentialRate, kabucomSor, kabucomLargeLot |
calc_dates | 権利日を入力すると、クロス取引に必要な各種日付・日数を計算して返す。
【入力 vestingDate】
・"2026-09-30" のような具体的な日付(その年で固定)
・"9月末" / "09" / "9"(月のみ)→ その月末で、次に到来する回
・"9月20日" / "09-20" / "9/20" / "0920" → その日で、次に到来する回
【tradeDate】省略時は「今注文したとき」の約定日(JST 15:30より前なら当日、以降なら翌営業日、
土日祝はさらに繰り上げ)。「今から」系の日数(interestDays 等)はこの日を起点にする。
【返す主なフィールド】
・vestingDate: 権利確定日(基準日) ・lastDayWithRights: 権利付最終日 ・exRightsDate: 権利落ち日
・interestDays: 今建てた場合の信用金利/ params: vestingDate*, tradeDate |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.