MCP · 给你的 agent

让你的 AI agent 帮你收租

把包租公接进你自己的 AI 助手——Codex、Claude Code、Claude Desktop 等。查持仓、找收租机会、看早安简报,不用打开 app,直接在你的 agent 里问。

读+可控写入 · 不下单· 不登录也能试· 标准 MCP + OAuth· 官方 Registry 收录
先试后连 连上之后不登录也能问任意一只票;登录才看得到你自己的仓,让 agent 帮你记账、对券商的账。全部 44 个工具是 Gold 会员权益。

这是什么

MCP(Model Context Protocol)是一个开放标准,让 AI agent 能调用外部工具。包租公实现了一个 MCP 服务器——你的 agent 连上后,就能以你的身份读取你的持仓、拿 RENT 排序的收租推荐、读早安简报;经你在 app 里开启写入后,还能帮你改 watchlist / 笔记 / 账户资料 / 持仓(每步可撤销,绝不下单)。所有「用自然语言统计 / 提问」的活由你自己的 agent(它的 LLM)完成,包租公只提供结构化的数据与计算。

它适合谁:已经活在 AI agent 工作流里的人。如果你只想简单看盘,直接用 app 就好——app 本身已经很简单。MCP 是给想把包租公塞进自己 agent 的进阶玩家的。

前提:① 一个 Gold 会员账号;② 一个支持 MCP 的客户端(Codex / Claude Code / mcporter / 个人版 Claude Desktop / claude.ai)。

怎么连接

不用先开会员也能试 — 连上之后不登录也能问任意一只票:find_recommendations(RENT 排序的收租候选,给排在最前的 3 张)、explain_option(你点名的那一张合约)、get_market_climate(今天的收租气候)。用的是中性口径,所以分数可能和你在 app 里看到的不一样。用免费账号连上,找合约就和 app 里一样扣次数(同一个余额)、给完整列表、按你自己的愿接清单 / 可用资金 / 人设打分(问它「我还剩几次」也答得上来);看你自己的仓、记账对账要 Gold —— 没用过试用的话,跟它说一声、确认一次就能直接开通 Gold 试用。
最省事:把这一页交给你的 agent — 把这页的链接(baozugong.app/mcp-guide)发给你的 Codex / Claude Code / Claude,说「帮我连上这个 MCP server」。连接要用的信息都在本页,它会按你客户端的格式自己写好配置。
在 Muse 里用 — 用的是 Meta 的 Muse?粘一段话它就自己接好,不用写配置文件 —— 看这一页。
服务器地址(endpoint) https://baozugong.app/api/mcp
传输方式 streamable-http
认证方式 OAuth 2.1 / Bearer API key
官方 Registry 名 app.baozugong/landlord

手动连接,四选一:

方式 A:静态密钥

Codex / Claude Code / mcporter
  1. 在 app 里生成密钥:头像 → 账户设置 → API / MCP 访问 → 生成密钥(只显示一次,复制保存)。
  2. 把上面的 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
  1. 设置 → 连接器 → 添加自定义连接器 → 填上面的 endpoint → 浏览器登录授权即可。不用手动贴密钥。
⚠️ 公司 / 组织托管的 Claude 常被管理员停用「自定义连接器」——那条路走不通时,改用方式 A(Codex 等)。

方式 C:官方 MCP Registry

支持 registry 的客户端
  1. 你的客户端若支持官方 MCP Registry,直接搜 app.baozugong/landlord 添加即可——endpoint 和认证会自动带上,不用手填。

方式 D:粘一段话

Muse 这类跑在服务器上的 agent
  1. 把下面这段原样发给你的 agent(保持英文就好,它接得更准;接好以后用中文问没问题)。它会自己接上包租公、先列出拿到了哪些工具。
  2. 要它看你自己的持仓时,它会发来一个链接和一个确认码:打开链接、登录包租公,核对页面上的确认码和它给的一样,点「授权」,再回去说一声「好了」—— 不用复制任何网址。
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 天路径 · 新闻 · 社区(几人在收 + 最近帖子和交易卡)。只给事实不写结论,总结交给你的 agentTSLA 现在适合出租吗?社区里大家在怎么做?
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 里,两边谁也不用把数据交给对方。

下面是包租公作者每天在跑的用法:从券商拉出昨天和今天的期权成交,逐笔核对包租公里记的对不对。

三步搭起来

  1. 注册 SnapTrade Personal → 授权你的券商 → 在你的 agent 里加它的 MCP(https://mcp.snaptrade.com/mcp,OAuth 一键授权,只读、不能下单)。
  2. 按本页「怎么连接」再加上包租公 MCP。
  3. 然后说人话就行:「列出我昨天和今天的期权交易,然后检查是否都在包租公里了」

支持 MCP prompts 的客户端里更省事:直接调 reconcile_broker,这套对账流程我们已经替你写好了(含「多腿记成一条、roll 认成一组、补录走可撤销的两段式」这些规矩)。想让它每天定时跑、不用你在旁边点头 → 改调 daily_broker_sync:同样的规矩,外加「一次批量写完」和「小数行权价照抄不许取整」,需要你在设置里另外打开自动对账开关。

你的 agent 两边各拉一次、逐笔比对,输出大概长这样:

券商成交数量成交价包租公里
平 QQQ 8/7 $680 Put5$0.08✅
平 PLTR 8/21 $105 Put20$0.09✅
开 SPCX 9/18 $95 Put10$5.35✅
平 SPCX 8/7 $150 Call3$0.03✅
开 SPCX 10/16 $150 Call3$5.24✅

两天十一笔,全部对上。值得看的是最后两行:agent 自己认出这是一组 roll(平掉近月、开出远月),包租公也就按 roll 记——展期的那条腿不会被当成一笔了结算进胜率。

核对完,要不要顺手记进来?

  1. 只想核对 — 什么开关都不用开。上面整套是纯读,agent 只是把两边摆在一起给你看。
  2. 差的几笔顺手补上 — 让它走 propose_position_edit → 你看 diff → commit_position_edit。需要在 app 里打开「允许我的 agent 修改我的数据」。
  3. 每天定点、无人值守 — sync_broker_activity 一次批量对账:开仓 / 平仓 / 展期,外加可用资金和正股快照。已有的自动跳过、可疑的列出来不写、整批一键撤销。需要另外打开「自动对账」开关。
边界说清楚:SnapTrade 是第三方产品、不是包租公的一部分——你自己去连、自己管授权(他们那边同样只读、不能下单)。我们看不到你的券商凭证;agent 从券商读到的东西,只有你让它写进来的那部分才会进包租公。换成别家券商聚合 MCP 也是一样拼法,不限于这一家。

进阶:搭一套收租智能体

如果你已经在用 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 里跑):

  1. 多空研究员:用 explain_score + get_market_climate + get_realized_performance 辩「被接货值不值持有」——不是猜涨跌。
  2. 三视角风控:用 find_recommendations 跑三档风险(保守 / 平衡 / 激进)+ compare_candidates 并排定 strike。
  3. 复盘台:用 get_realized_performance 把这个票上次的教训喂回这次决策。
  4. 你拍板:满意了才让 agent 走 propose_position_edit → 你看 diff → commit_position_edit 落库。绝不下单、每步可撤销。
两条内置捷径:支持 prompts 的客户端里,直接调 debate_candidate(多空接货辩论)或 risk_lens_scan(风险三视角)——它们把上面的编排打包好了,一句话触发。

边界与安全

  • 永不下单、不碰资金。看 / 分析 / 给候选是默认;改 watchlist / 笔记这类写入需要你在 app 里显式打开,且每步可一键撤销。
  • 不是投资建议。RENT 分和一切输出仅供信息参考,交易决策与后果由你自负。
  • 密钥 = 你的账号。妥善保管,别贴进聊天记录 / 截图 / commit。怀疑泄露就在账户设置里吊销、另生成一个。
  • 数据可能延迟或有误。行情、定价、Greeks 都是估算,可能与你券商显示不一致。
回到 app 账户设置生成密钥 开通 Gold 会员 · 免费试用