株主優待 MCP (Yutai MCP) について
株主優待 MCP (Yutai MCP)
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
エンドポイント
https://yutai-mcp.web.app/mcpインストールコマンドをコピー
Claude CodeTerminal
claude mcp add --transport http app-web-yutai-mcp-yutai https://yutai-mcp.web.app/mcpCursor.cursor/mcp.json
{"mcpServers":{"app-web-yutai-mcp-yutai":{"type":"http","url":"https://yutai-mcp.web.app/mcp"}}}Cursor で開くVS Code.vscode/mcp.json
{"servers":{"app-web-yutai-mcp-yutai":{"type":"http","url":"https://yutai-mcp.web.app/mcp"}}}VS Code で開くClaude Desktopclaude_desktop_config.json
{"mcpServers":{"app-web-yutai-mcp-yutai":{"type":"http","url":"https://yutai-mcp.web.app/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"app-web-yutai-mcp-yutai":{"serverUrl":"https://yutai-mcp.web.app/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
4| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| date | string | いいえ | netYield計算の約定日 (YYYY-MM-DD)。省略時は「今」から自動算出(JST 15:30より前なら当日、以降なら翌営業日) |
| limit | number | いいえ | 最大件数 (デフォルト20) |
| order | enum | いいえ | 並び順。省略時のデフォルトは sortBy 依存(nextVestingDate/requiredFunds は asc、それ以外は desc)asc | desc |
| anyDay | boolean | いいえ | 長期条件の判定で、決まった基準日以外にも「任意の日」に保有状況を抜き打ちで確認すると明記されている銘柄かどうか。trueにするとそれに該当する銘柄のみ返す(基準日だけクロスで確保しても長期条件を満たせない可能性がある、要注意銘柄) |
| gmoVip | boolean | いいえ | GMO VIPプラン。既定false |
| sbiVip | boolean | いいえ | SBI大口優遇(建玉5億円以上)。既定false |
| sortBy | enum | いいえ | 並べ替えキー。actualYield=実質利回り(手数料考慮なし) / netYield=手取り利回り(必要クロスコスト〈逆日歩除く〉を引いた後) / minValue=優待評価額 / requiredFunds=必要資金 / prevLendingInterest=前回の逆日歩率 / nextVestingDate=次回権利確定日 / update=優待内容が最後に変更された日。省略時は並べ替えなし。値を持たない銘柄は order によらず末尾actualYield | netYield | minValue | requiredFunds | prevLendingInterest | nextVestingDate | update |
| keyword | string | いいえ | 部分一致検索。対象: 銘柄コード / 銘柄名 / サマリー / 詳細説明(description) / 更新メモ(updateNote) / 優待内容の各候補テキスト(details[].candidates[].detail)。「コストコ」「株主優待券」など優待の中身でも検索できる。例: "3397", "すかいらーく", "コストコ" |
| karaDate | string | いいえ | 空クロスが必要な月または月日で絞り込む。「○月に空クロスが必要な銘柄」を探す場合はここを使う。例: "05"=5月, "05-20"=5月20日。vestingDate（権利確定日）とは別物なので混同しないこと。 |
| longType | enum | いいえ | 長期保有条件の完全一致。none=なし, longAddition=長期優遇, longOnly=長期必須none | longAddition | longOnly |
| maxValue | number | いいえ | 絞り込みたい優待評価額の上限 (円)。優待自身の評価額の範囲(出力のminValue〜maxValue)がminValue引数〜この上限の範囲に少しでも重なる銘柄を返す(単一値の一致ではない)。例: 10000 = 10000円以下を含む銘柄 |
| minValue | number | いいえ | 絞り込みたい優待評価額の下限 (円)。優待自身の評価額の範囲(出力のminValue〜maxValue)がこの下限〜maxValue引数の範囲に少しでも重なる銘柄を返す(単一値の一致ではない)。例: 1000 = 1000円以上を含む銘柄 |
| updateTo | string | いいえ | 優待内容が変更された日(update)の上限 (YYYY-MM-DD)。例: "2026-05-31" → 5月末までに優待内容が変更された銘柄 |
| maxRarity | enum | いいえ | 一般信用クロスの取得難易度(前回権利時の在庫推移から算出)の上限。例: "C" → C,D,Eの取りやすい銘柄のみS | A | B | C | D | E |
| minRarity | enum | いいえ | 一般信用クロスの取得難易度(前回権利時の在庫推移から算出)の下限。S>A>B>C>D>E。例: "A" → AまたはSの難しい銘柄のみS | A | B | C | D | E |
| kabucomSor | boolean | いいえ | カブコムSOR(スマート・オーダー・ルーティング)。既定false |
| karaDateTo | string | いいえ | 次回空クロス日の上限 (YYYY-MM-DD)。例: "2026-05-31" → 5月末までに空クロスが必要な銘柄 |
| rakutenVip | boolean | いいえ | 楽天大口優遇。既定false |
| updateFrom | string | いいえ | 優待内容が変更された日(update)の下限 (YYYY-MM-DD)。例: "2026-05-01" → 5月1日以降に優待内容が変更された銘柄 |
| lendingType | enum | いいえ | 信用取引区分。both=制度クロス可, buying_only=空クロス必要, none=クロス不可both | buying_only | none |
| maxNetYield | number | いいえ | 手取り利回りの上限 (%) |
| minNetYield | number | いいえ | 手取り利回りの下限 (%)。例: 0.5 = 手数料を引いても0.5%以上 |
| requireKara | boolean | いいえ | true=空クロスが必要な日付（karaDates）がある銘柄のみ / false=karaDatesがない銘柄のみ |
| sellCaution | boolean | いいえ | 制度信用の注意喚起(増担保・申込停止等)。true=注意喚起中の銘柄のみ / false=注意喚起でない銘柄のみ |
| vestingDate | string | いいえ | 権利確定月または月日で単一絞り込み。例: "03"=3月, "03-20"=3月20日 (vestingDates配列に対してマッチ) |
| benefitTypes | array | いいえ | 優待種別（OR検索）。例: ["QUO","MealTicket"]。指定した種別のいずれかを持つ銘柄を返す。種別一覧: QUO, RiceVoucher, CashVoucher, JEFVoucher, MealTicket, FacilityTicket, ShoppingTicket, HotelTicket, TransportTicket, OtherTicket, CatalogGift, PYC, Electronics, Fashion, OtherItems, Fruit, Meat, Fish, Drink, Liquor, Rice, Sweets, OtherMeal |
| excludeCodes | array | いいえ | 除外する銘柄コード配列 |
| karaDateFrom | string | いいえ | 次回空クロス日の下限 (YYYY-MM-DD)。例: "2026-05-01" → 5月以降に空クロスが必要な銘柄 |
| minRemain_gmo | any | いいえ | GMO 一般信用残数の下限。few=△以上, remaining=◎のみ |
| minRemain_sbi | enum | いいえ | SBI 一般信用残数の下限。few=△以上(△または◎), remaining=◎のみ。canNormalSelling_sbi=enableSelling と併用推奨few | remaining |
| rakutenCourse | enum | いいえ | 楽天のコース。既定"zero"(ゼロコース)zero | chowari |
| vestingDateTo | string | いいえ | 次回権利確定日の上限 (YYYY-MM-DD)。nextVestingDate <= この値の銘柄を返す |
| maxActualYield | number | いいえ | 実利回り上限 (%)。優待の申込単位のうち達成可能な最良の額面利回りで、クロスの手数料・貸株料・逆日歩は含まない。手数料込みで絞るには maxNetYield を使う。株価データが無い銘柄(price未取得)はこの条件では判定できないため除外される。例: 5.0 = 5%以下 |
| minActualYield | number | いいえ | 実利回り下限 (%)。優待の申込単位のうち達成可能な最良の額面利回りで、クロスの手数料・貸株料・逆日歩は含まない。手数料込みで絞るには minNetYield を使う。株価データが無い銘柄(price未取得)はこの条件では判定できないため除外される。例: 1.0 = 1%以上 |
| minRemain_smbc | number | いいえ | SMBC日興 一般信用残数の下限（株数） |
| sellProhibited | boolean | いいえ | 制度信用の売禁(新規売り停止)。true=売禁の銘柄のみ / false=売禁でない銘柄のみ。データ未取得は「規制なし」扱い |
| sellRestricted | boolean | いいえ | 売禁または注意喚起(制度信用の要注意銘柄)。true=いずれかに該当する銘柄のみ / false=どちらでもない銘柄のみ |
| kabucomLargeLot | enum | いいえ | カブコム大口優遇ランク。既定"none"crown | diamond | sapphire | platinum | gold | silver | none |
| vestingDateFrom | string | いいえ | 次回権利確定日の下限 (YYYY-MM-DD)。nextVestingDate >= この値の銘柄を返す |
| hasLongCondition | boolean | いいえ | trueにすると長期条件あり銘柄 (longAddition または longOnly) のみ返す |
| maxRequiredFunds | number | いいえ | 必要資金の上限 (円)。株価×minRequiredUnits で計算。株価データが無い銘柄(price未取得)はこの条件では判定できないため除外される |
| minRequiredFunds | number | いいえ | 必要資金の下限 (円)。株価×minRequiredUnits で計算。株価データが無い銘柄(price未取得)はこの条件では判定できないため除外される |
| minRemain_kabucom | number | いいえ | カブドットコム 一般信用残数の下限（株数） |
| minRemain_rakuten | number | いいえ | 楽天 一般信用残数の下限（株数）。例: 1000 = 1000株以上 |
| sbiZeroRevolution | boolean | いいえ | SBIゼロ革命(電子交付設定)。既定true |
| minRemain_any_count | number | いいえ | 楽天・カブコム・SMBCのいずれかで指定した株数以上の一般信用残数がある銘柄 (OR検索)。例: 1 → どこかに在庫あり, 2000 → どこかに2000株以上 |
| canNormalSelling_any | enum | いいえ | いずれかの証券会社で条件を満たす銘柄を返す (OR検索)。「どこかで一般信用売りができる銘柄」を探すときに使う。個別の canNormalSelling_* と併用すると AND になる。enableSelling=売り可, enableLongSelling=長期売りのみenableSelling | enableLongSelling | notEnableSelling |
| canNormalSelling_gmo | any | いいえ | GMO 一般信用売り可否 |
| canNormalSelling_sbi | any | いいえ | SBI 一般信用売り可否。enableSelling=売り可, enableLongSelling=長期売りのみ, notEnableSelling=不可 |
| canNormalSelling_smbc | any | いいえ | SMBC日興 一般信用売り可否 |
| maxPrevLendingInterest | number | いいえ | 前回逆日歩率(1日あたり・株価に対する比率)の上限。例: 0.01 = 1日あたり1%以下 |
| minPrevLendingInterest | number | いいえ | 前回逆日歩率(1日あたり・株価に対する比率)の下限。例: 0.005 = 1日あたり0.5%以上 |
| maxMarginRateMultiplier | number | いいえ | 増担保金徴収措置による最高料率倍率(marginRateMultiplier)の上限。措置が無い銘柄は対象外になる。例: 10 = 10倍以下 |
| minMarginRateMultiplier | number | いいえ | 増担保金徴収措置による最高料率倍率(marginRateMultiplier)の下限。措置が無い銘柄は対象外になる。例: 5 = 5倍以上 |
| rakutenPreferentialRate | boolean | いいえ | 楽天優遇金利適用。既定false |
| canNormalSelling_kabucom | any | いいえ | カブドットコム 一般信用売り可否 |
| canNormalSelling_rakuten | any | いいえ | 楽天 一般信用売り可否 |
詳細
メンテナーはまだ詳細を追加していません。リポジトリの README をご覧ください。
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。