这是什么
MCP(Model Context Protocol)是一个开放标准,让 AI agent 能调用外部工具。包租公实现了一个 MCP 服务器——你的 agent 连上后,就能以你的身份读取你的持仓、拿 RENT 排序的收租推荐、读早安简报;经你在 app 里开启写入后,还能帮你改 watchlist / 笔记 / 账户资料 / 持仓(每步可撤销,绝不下单)。所有「用自然语言统计 / 提问」的活由你自己的 agent(它的 LLM)完成,包租公只提供结构化的数据与计算。
它适合谁:已经活在 AI agent 工作流里的人。如果你只想简单看盘,直接用 app 就好——app 本身已经很简单。MCP 是给想把包租公塞进自己 agent 的进阶玩家的。
怎么连接
find_recommendations(RENT 排序的收租候选,给排在最前的 3 张)、explain_option(你点名的那一张合约)、get_market_climate(今天的收租气候)。用的是中性口径,所以分数可能和你在 app 里看到的不一样。用免费账号连上,找合约就和 app 里一样扣次数(同一个余额)、给完整列表、按你自己的愿接清单 / 可用资金 / 人设打分(问它「我还剩几次」也答得上来);看你自己的仓、记账对账要 Gold —— 没用过试用的话,跟它说一声、确认一次就能直接开通 Gold 试用。
baozugong.app/mcp-guide)发给你的 Codex / Claude Code / Claude,说「帮我连上这个 MCP server」。连接要用的信息都在本页,它会按你客户端的格式自己写好配置。
https://baozugong.app/api/mcpstreamable-httpOAuth 2.1 / Bearer API keyapp.baozugong/landlord手动连接,四选一:
方式 A:静态密钥
Codex / Claude Code / mcporter- 在 app 里生成密钥:头像 → 账户设置 → API / MCP 访问 → 生成密钥(只显示一次,复制保存)。
- 把上面的 endpoint 和密钥交给你的 agent——最省事的是直接贴给 Codex / Claude Code,让它自己写 config。或手动写进配置文件,例如 Codex 的
~/.codex/config.toml:
[mcp_servers.baozugong]
url = "https://baozugong.app/api/mcp"
bearer_token_env_var = "BZG_TOKEN"
enabled = true然后把密钥放进环境变量(别提交进 git):
export BZG_TOKEN="bzg_live_…你的密钥 / your key"方式 B:OAuth 一键
个人版 Claude Desktop / claude.ai- 设置 → 连接器 → 添加自定义连接器 → 填上面的 endpoint → 浏览器登录授权即可。不用手动贴密钥。
方式 C:官方 MCP Registry
支持 registry 的客户端- 你的客户端若支持官方 MCP Registry,直接搜
app.baozugong/landlord添加即可——endpoint 和认证会自动带上,不用手填。
方式 D:粘一段话
Muse 这类跑在服务器上的 agent- 把下面这段原样发给你的 agent(保持英文就好,它接得更准;接好以后用中文问没问题)。它会自己接上包租公、先列出拿到了哪些工具。
- 要它看你自己的持仓时,它会发来一个链接和一个确认码:打开链接、登录包租公,核对页面上的确认码和它给的一样,点「授权」,再回去说一声「好了」—— 不用复制任何网址。
Connect to YieldLord (option-income tools) over MCP:
https://baozugong.app/api/mcp
- Standard MCP over streamable HTTP. Replies are plain JSON (not SSE) and the server is stateless, so don't wait for a stream to close and don't carry an Mcp-Session-Id. No sign-in needed to start.
- Call tools/list, tell me which tools you got, and use them for any question about covered calls, cash-secured puts, the wheel or option income.
- When I ask you to connect my account: call connect_my_account with start_link=true and agent_name set to your own name, then show me the link and the code. After I say I approved, call connect_my_account with pickup=<the pickup you got>, send the access_token as "Authorization: Bearer <token>" on every request, and call tools/list again.有哪些工具
现在 44 个工具:读取(默认可用)+ 写入(改 watchlist / 笔记 / 账户资料 / 持仓,需你在 app 打开、每步可撤销)。用大白话问你的 agent 就行,它自己挑。
没登录时只有 4 只:find_recommendations · explain_option · get_market_climate · connect_my_account(默认只回一句说明和一个链接;你的 agent 带上 start_authorization 再调一次,就会当场发起登录授权)。其余的调用会让你的客户端弹出登录授权。还不是 Gold 会员也没关系:授权页上可以一键开始免费试用(不绑卡 · 每个账号一次),开通的同时就连上了。跑在服务器上、接不住浏览器跳转的 agent(比如 Muse)可以改用 start_link:它给你一个链接,你点开登录、批准就连上了,不用复制网址。
| 工具 | 做什么 | 你可以这样问 |
|---|---|---|
get_positions | 你的持仓 + 实时定价 / Greeks / 盈亏 | 我所有仓位里哪些这周到期? |
portfolio_stats | 组合汇总:总盈亏 / 净 Greeks / 集中度 | 我组合的净 delta 是多少?科技股占比会不会太高? |
find_recommendations | 某标的的 RENT 排序收租候选(单腿裸卖,或带保护腿的信用价差) | 我不裸卖,只做垂直价差 —— 找 TSLA 的 |
scan_watchlist | 多标的批量扫(默认你的 watchlist)· 同样支持信用价差 | 扫我的 watchlist,哪些 IV 高、适合卖 put? |
explain_score | 某合约为什么是这个包租公分(因子分解) | 为什么我这张 NVDA covered call 只有 3 星? |
explain_option | 解释你点名的那一张合约(引擎没挑中的也行):报价 / Greeks / 年化 / 到期作废概率 / 包租公分,跟 app 同一套算术。报不出来就说报不出来,不拿邻近那张顶替 | TSLA 10 月 16 号 420 的 put 现在卖出去怎么样? |
get_position_defense | 某张持仓的防守 facts:接货风险 / 出场计划 / roll 候选 / 检查点 | 我这张深 ITM 的 put 该怎么办? |
get_market_climate | 现在的收租气候(大盘 regime + VIX + 宏观临近) | 现在收租气候怎么样? |
get_morning_brief | 今天的早报底稿(持仓进度 / 气候 / 趋势 · 结构化,让 agent 自己讲) | 今天包包怎么说? |
get_watchlist | 你的 IV 提醒清单(≠ 愿接清单) | 我 watchlist 里有哪些标的? |
get_account_profile | 你的账户资料:会员(试用还是付费 · 哪天到期 · 还剩几天)/ 关注标的 / 愿接清单 / 受限标的 / 可用资金 / 正股 / 默认人设(与 app 账户设置同一份) | 我愿接清单里有哪些票? |
get_followed_tickers | 你关注的标的(标的三层 层①)+ 每条的提醒开关 + 是否已升到「愿意接」 | 我关注了哪几只票? |
get_realized_performance | 已实现收租战绩:逐月 + 累计 + 最近平仓(月度总结 / 复盘用) | 这个月我收了多少?帮我复盘最近几笔 |
get_ticker_history | 某一只票的完整账本:你记过的每一张(开仓日 / 权利金 / 怎么平的 / 实现盈亏)+ 串好的 wheel 轮次(put 被接货 → 正股 → 卖 call → 被叫走,连展期前腿),附「若被叫走」的合计。读全部历史,不只最近几笔 | 我 RKLB 这一整轮 wheel 如果被叫走,一共赚多少? |
get_ticker_overview | 某一只票的标的页,原样交给你的 agent:IV 贵不贵(对它自己的区间 / 对实际波动)· 趋势 · 财报 · 页面自己标出的「今天值得说」· 今天分数最高那张 · 期权盘口(墙 / PCR / Max Pain / gamma / 新流入)· 未来 20 天路径 · 新闻 · 社区(几人在收 + 最近帖子和交易卡)。只给事实不写结论,总结交给你的 agent | TSLA 现在适合出租吗?社区里大家在怎么做? |
compare_candidates | 把 2-5 个候选按该看的指标横向对比(标最优 / 最差 + 高低方向) | 帮我对比这两个 CSP,哪个更划算? |
lookup_expired_contract | 过期合约结算:给一张已到期的期权(含多腿),用标的到期收盘判归属(归零 / 被接货 / 被叫走)+ 内在价值 + 盈亏——核对过去的交易。只读、不碰退市期权报价、拿不到不硬猜 | 我 7 月那张 AMD $140 put 到期是归零了还是被接货? |
list_alerts | 你开着哪些提醒:通知分类 + 逐仓「到点落袋」(连那条百分比一起)+ 自选 IV 提醒 | 我现在开了哪些提醒? |
check_alerts | 现在这几张仓值得知道什么(跟 app 里那颗铃同一套判据):接货档位 / 哪几张价内 / 到期周 / 到点可落袋 / 3 天内的财报除息。是当前状态,问几次答案都一样 | 我的仓现在有什么要注意的吗? |
alert_history | 铃真的发过什么(新的在前)。「我不在的时候出过什么事」问它;「现在是什么情况」问 check_alerts | 我这两天错过了什么提醒? |
| ↓ 写入工具 · 需你在 app 打开写入权限,每步可撤销 | ||
send_feedback | 给包租公团队留言 / 报 bug | 帮我给团队报个 bug:导入截图识别错了 |
get_my_feedback | 你提过的留言 / bug 现在什么状态、团队回了什么(只看得到你自己的) | 我上次报的那个 bug 有回音了吗? |
follow_ticker | 关注一只票(不用给阈值 —— 「现在没什么好时机,但先关注上」正是它的用法) | 关注一下 SOFI |
unfollow_ticker | 取消关注一只票 | 别盯 SOFI 了 |
add_to_watchlist | 关注 + 顺带开 IV 提醒(不给阈值 = 等同 follow_ticker) | 把 TSLA 加进 watchlist,IV 到 40 提醒我 |
remove_from_watchlist | 从 watchlist 移除标的 | 把 NVDA 从我的 watchlist 删掉 |
add_note | 给某张持仓记一条交易笔记 | 给我这张 TSLA put 记一笔:打算跌破 400 就 roll |
delete_note | 删掉某张持仓的一条笔记 | 把那条笔记删了 |
undo_last_edit | 撤销 agent 上一次的改动 | 撤销你刚才的修改 |
sync_broker_now | 从你连的券商拉一次持仓和成交 | 帮我同步一下券商 |
reconcile_broker_positions | 只读对账:券商和账本逐条比,回四桶 + 已平仓成交历史 | 我的持仓和券商对得上吗 |
list_broker_pending | 列出同步没写、等你确认的那些(外加:已导入还没核对的;以及看起来是一笔多腿的——两条单腿像双边收租,或者某条被记成裸卖的其实是价差的卖腿) | 有什么要我确认的吗 |
resolve_broker_pending | 把一条待确认摘掉(记账是另一步) | 那条我判断不用记,摘掉吧 |
undo_sync_batch | 整批撤销一次自动对账 | 把刚才那次同步撤了 |
set_willing_to_own | 标 / 取消某标的「愿接货」(愿接的票 CSP 优先) | 把 SPY 加进我的愿接清单 |
set_restricted | 标 / 解除「受限」(受限票绝不被建议交易) | 把 META 设成受限,别推荐它 |
set_buying_power | 设置可用资金 / buying power | 把我的可用资金设成 5 万 |
set_account_value | 记录融资借款 / 账户净值(资金出租率的分母) | 我 margin 借了 25 万,记一下 |
set_stock_holding | 设置 / 清除某标的正股持仓(算能卖几张备兑) | 我持有 300 股 AAPL,成本 210 |
set_default_persona | 设置默认出场风格(早平 / wheel / 持到期) | 默认帮我早平(约 50%) |
propose_position_edit | 预览一次持仓改动(加/平/改/删·单腿或多腿 strangle/价差·期货期权 /ES 也行·先给 diff 你确认,写明记进哪个账户) | 我刚卖了张 TSLA put $400 ×2,记一下 |
commit_position_edit | 你看过 diff 确认后才落库 | 确认,就这样记 |
sync_broker_activity | 无人值守批量对账券商活动:持仓(新开 / 平仓 / 展期一次记完·单腿+多腿)+ 账户(可用资金 + 正股快照·没建过账户可顺手建)。已有的跳过(手输的那笔被券商对上就确认为真单·社区卡亮券商核验戳)·可疑的列出不写·可整批撤销·需单独打开「自动对账」开关 | 每天 11 点读我 IBKR 的持仓、成交、可用资金和正股,全部同步进包租公 |
confirm_broker_match | 对账命中就确认为「券商核验」:你的 agent 拿券商真实成交跟包租公对上后,把命中的手输仓标成核验(社区卡亮玑镂戳·手输仓顺带转自动对账)。不建仓不改价——仓已在、只差确认。「帮我核对这两天成交在不在」这种,对上的就顺手盖戳;只该对真去券商核过的仓用 | 帮我核对这两天的成交,包租公上都有吗——对上的就标成券商核验 |
操作细则不放在这页:agent 写数据时要怎么配合(多账户怎么带 id · 展期要三步 · 回填已了结的老单子 · 「净资产怎么少了一块」…)已经做成 MCP 的一条参考文档 landlord://operating-notes,你的 agent 连上之后自己会读到 —— 你不用管。
预置工作流(Prompts):支持 MCP prompts 的客户端里,可以直接调用几条打包好的工作流——morning_rent_check(早安收租体检)· portfolio_review(组合体检)· find_income(找收租机会)· defend_position(守某张仓)· debate_candidate(多空接货辩论)· risk_lens_scan(风险三视角)· reconcile_broker(券商对账)· daily_broker_sync(每日券商同步)· reconcile_expired_trades(核对过期交易)。它们会让你的 agent 自动串起该用的工具。
你可以这样用
因为问话由你的 agent 理解、我们只给数据,你能问得很自由,还能跟你自己的其他工具拼起来:
- 这个月我一共收了多少权利金?年化多少?你的 agent 拉全部持仓自己算——app 没有的视角也能问。
- 哪些仓的 delta 漂到 0.4 以上了、该 roll 了?持仓 + Greeks 一起看,自己标出要处理的。
- 我有 5000 刀 buying power,现在最值得收租的 3 个机会?找推荐 + 按你的资金二次筛选。
- 每天早上把简报 + 扫一遍我的 watchlist,汇总发我邮件。你在自己的 agent 里搭这条例程——我们只提供工具,编排由你。
- 把包租公里记的持仓,和我券商账户实际持仓核对一下。跨工具:你的 agent 两边都连着,自己对账。
- 我上个月那几张到期的 put,是归零了还是被接货?你的 agent 逐张用「过期合约结算」核对到期归属,还能跟你券商记录对上。
- 把我这些已经到期 / 平掉的老单子都补进包租公。用 add_closed 回填已了结的交易(到期日可在过去),一步进战绩、可撤销。
真实案例:券商 → 包租公,每天对账
包租公不连你的券商——我们不碰你的券商凭证,也不打算碰。但你的 agent 可以两边都连:一边是券商聚合 MCP(例如 SnapTrade Personal,个人自用免费、只读、覆盖 Schwab / Fidelity / Robinhood 等二十多家),另一边是包租公 MCP。对账就发生在你自己的 agent 里,两边谁也不用把数据交给对方。
下面是包租公作者每天在跑的用法:从券商拉出昨天和今天的期权成交,逐笔核对包租公里记的对不对。
三步搭起来
- 注册 SnapTrade Personal → 授权你的券商 → 在你的 agent 里加它的 MCP(
https://mcp.snaptrade.com/mcp,OAuth 一键授权,只读、不能下单)。 - 按本页「怎么连接」再加上包租公 MCP。
- 然后说人话就行:「列出我昨天和今天的期权交易,然后检查是否都在包租公里了」
支持 MCP prompts 的客户端里更省事:直接调 reconcile_broker,这套对账流程我们已经替你写好了(含「多腿记成一条、roll 认成一组、补录走可撤销的两段式」这些规矩)。想让它每天定时跑、不用你在旁边点头 → 改调 daily_broker_sync:同样的规矩,外加「一次批量写完」和「小数行权价照抄不许取整」,需要你在设置里另外打开自动对账开关。
你的 agent 两边各拉一次、逐笔比对,输出大概长这样:
| 券商成交 | 数量 | 成交价 | 包租公里 |
|---|---|---|---|
| 平 QQQ 8/7 $680 Put | 5 | $0.08 | ✅ |
| 平 PLTR 8/21 $105 Put | 20 | $0.09 | ✅ |
| 开 SPCX 9/18 $95 Put | 10 | $5.35 | ✅ |
| 平 SPCX 8/7 $150 Call | 3 | $0.03 | ✅ |
| 开 SPCX 10/16 $150 Call | 3 | $5.24 | ✅ |
两天十一笔,全部对上。值得看的是最后两行:agent 自己认出这是一组 roll(平掉近月、开出远月),包租公也就按 roll 记——展期的那条腿不会被当成一笔了结算进胜率。
核对完,要不要顺手记进来?
- 只想核对 — 什么开关都不用开。上面整套是纯读,agent 只是把两边摆在一起给你看。
- 差的几笔顺手补上 — 让它走
propose_position_edit→ 你看 diff →commit_position_edit。需要在 app 里打开「允许我的 agent 修改我的数据」。 - 每天定点、无人值守 —
sync_broker_activity一次批量对账:开仓 / 平仓 / 展期,外加可用资金和正股快照。已有的自动跳过、可疑的列出来不写、整批一键撤销。需要另外打开「自动对账」开关。
进阶:搭一套收租智能体
如果你已经在用 TradingAgents 这类多智能体框架(或想自己搭一套),可以把包租公当成一个「收租专业台」接进去:你的 agent 舰队负责讨论 / 辩论 / 拍板,包租公负责给一家收租公司该有的数据、打分、风控事实、战绩和可撤销执行。决策的 LLM 始终是你自己的——我们不替你判断,也绝不下单。
| 公司里的台 | 用哪些工具 |
|---|---|
| 数据 / 情报台 | get_ticker_overview · get_market_climate · explain_score · scan_watchlist |
| 筛选 / 量化台 | find_recommendations · compare_candidates |
| 风控台 | get_position_defense · portfolio_stats |
| 复盘 / 记忆台 | get_realized_performance · get_ticker_history |
| 执行台 | propose_position_edit → commit_position_edit |
一套典型的收租编排(你在自己的 agent 里跑):
- 多空研究员:用
explain_score+get_market_climate+get_realized_performance辩「被接货值不值持有」——不是猜涨跌。 - 三视角风控:用
find_recommendations跑三档风险(保守 / 平衡 / 激进)+compare_candidates并排定 strike。 - 复盘台:用
get_realized_performance把这个票上次的教训喂回这次决策。 - 你拍板:满意了才让 agent 走
propose_position_edit→ 你看 diff →commit_position_edit落库。绝不下单、每步可撤销。
debate_candidate(多空接货辩论)或 risk_lens_scan(风险三视角)——它们把上面的编排打包好了,一句话触发。
边界与安全
- 永不下单、不碰资金。看 / 分析 / 给候选是默认;改 watchlist / 笔记这类写入需要你在 app 里显式打开,且每步可一键撤销。
- 不是投资建议。RENT 分和一切输出仅供信息参考,交易决策与后果由你自负。
- 密钥 = 你的账号。妥善保管,别贴进聊天记录 / 截图 / commit。怀疑泄露就在账户设置里吊销、另生成一个。
- 数据可能延迟或有误。行情、定价、Greeks 都是估算,可能与你券商显示不一致。