# Monk Muse

> Muse 邀请码共享池：免费领 Muse 邀请码，用户也可以把自己多的码分享进来。独立社区项目，和 Meta 无关；不保证兑换成功，别为邀请码付费。

- 网页：https://muse.monk.party/
- 注册教程（微信文章）：https://mp.weixin.qq.com/s/ek_l18zZAtqp9g9YXqaa2Q

## HTTP 接口

- `GET /api/pool` → `{"stats": {"active": 可领码数, "confirmed": 兑换成功反馈数}, "recent": [{"id", "code", "createdAt"(毫秒时间戳), "handouts", "estimatedLeft"}]}`，最新 12 个。只读。
- `POST /api/codes/next` → `{"id", "code", "estimatedLeft"}`：领一个码（给被领得最少的那个），计一次领取。码池空时 404。
- `POST /api/codes/{id}/report`，JSON `{"result": "worked" | "used"}`：用户在 Muse 里**真的试过以后**回报结果。同一个码 3 次 used 会下架。
- `POST /api/codes`，JSON `{"code": "K4M2QP"}`：分享用户自己的码（4–12 位字母或数字）。201=放进去了，200 且 `created:false`=已经在池里，400=格式不对，429=太频繁（每个 IP 10 分钟 8 次）。

「estimatedLeft」是本站按领取次数和反馈估的，不是 Muse 官方数字。

## MCP

Streamable HTTP：`https://muse.monk.party/mcp`

工具：
- `pool_status`：码池概况和最新分享的码（只读）
- `claim_code`：领一个码
- `report_code`：`{id, result: "worked"|"used"}` 回报结果
- `share_code`：`{code}` 分享用户自己的码（只在用户明确同意时调用）

## 所属

monk 宇宙的一颗星球：https://universe.monk.party/