内容
# k402-mcp — 按次付费的AI智能体API，结算于Kaspa
一个MCP服务器，为任何智能体（Claude Code，Claude Desktop，智能体SDK）提供**可支付API**目录：
**可支付API**：文本工具（总结，模式保证提取，分类，重写），
网页读取，嵌入 + 语义搜索，实时Kaspa主网链数据，GPU模型层，
服务合约（编译/导出/检查/构建/广播Silverscript服务合约），和
RISC Zero证明服务（上传访客，预飞行获取报价，证明，验证）。
**无需账户，无需卡，无需API密钥** — 智能体打开会话，获取个人KAS存款地址，
每次调用都计费于预付余额。价格以美元计价，千分之一美分每次调用，在Kaspa L1结算（亚秒级，接近零手续费）。
支付循环是智能体原生的：未资助的调用返回**指令**（"将KAS发送到此地址，此调用费用为X"），
所以智能体可以发现服务，了解如何支付，并自主使用 — [x402](https://www.x402.org/) 想法，在Kaspa上。
## 主持端点 — 零安装
相同的服务器在公共网关（可流式HTTP）上运行：
```
https://x402-compute.68cxgfyr0.workers.dev/mcp
```
Claude Code：
```bash
claude mcp add --transport http k402 https://x402-compute.68cxgfyr0.workers.dev/mcp
```
托管会话是**每个连接**：`open_session` 将支付会话绑定到您的MCP连接并返回密钥 — 保存它，
并在重新连接后使用 `use_session(<key>)` 重新连接。连接之间不共享任何内容。
## 安装（本地stdio）
```bash
pip install k402-mcp
```
Claude Code：
```bash
claude mcp add k402 -- k402-mcp
```
Claude Desktop / 通用MCP配置：
```json
{ "mcpServers": { "k402": { "command": "k402-mcp" } } }
```
环境变量（所有可选）：`K402_GATEWAY` （默认为公共网关），`K402_SESSION` （固定一个资助会话密钥），
`K402_STATE` （自动打开的会话持续存在，默认为 `~/.k402/session.json` ）。
## 使用
1. `catalog` — 查看每个服务及其实时KAS/USD价格（免费）
2. `open_session` — 获取会话 + 个人Kaspa主网存款地址（免费）；从任何钱包资助它（最小0.25 KAS — 数秒确认）
3. 调用任何服务：`summarize`，`extract`，`classify`，`rewrite`，`read_url`，`embed_text`，
`search_index`/`search_query`，`kaspa_balance`，`kaspa_utxos`，`kaspa_tx_status`，
`kaspa_fee_estimate`，`kaspa_network`，`generate` （层级：聊天 / llama / 原因 / 思考 / 代码 / kaspa专家），
`covenant_compile`/`covenant_address`/`covenant_utxos`/`covenant_build`/`covenant_check`/`covenant_broadcast`，
`prove_guest_upload`/`prove_preflight`/`prove_submit`/`job_status`/`job_result`/`attest_verify`，
`payment_options`，`pay_per_call`
4. `session_status` — 查看余额减少（免费）
**新来者？从 `open_session` 开始** — 一个资助存款地址，每次调用都计费于它。那就是整个循环。
其他方案（每次调用的硬币，或无信任支付通道）适用于您想要它们时；`payment_options` 解释每个方案。
### 无信任支付通道 (`kaspa-channel`)
在网关提供的地方，`channel_config`/`channel_status` 公开一个服务合约支付通道：
您的KAS位于Kaspa L1服务合约（不是商户的钱包）中，您通过签名凭证按次支付 —
商户只能获得您签名的金额，您可以取回其余部分。打开和资助通道需要您的Kaspa密钥，
所以该部分在 [`k402`](https://pypi.org/project/k402/) Python客户端（`k402.channel`）中运行；
这些MCP工具涵盖发现和状态。
示例，在Claude Code中 `claude mcp add` 之后：
> "使用k402工具检查当前的Kaspa网络状态并总结 https://kaspa.org"
第一个调用返回如何支付的指令；资助它给出的存款地址并重试。
## 注意事项和诚实的警告
- **原型。** 支付结算为托管预付费（会话）或通过 `kaspa-channel` 服务合约支付通道（在主网上运行，服务合约未经审计 — 通道大小上限）。保持余额小：几KAS覆盖数千次调用。
- 付费工具返回 `payment_required` + 指令而不是不明确失败。
- 网关按IP限制速率；价格随KAS/USD浮动，因此 `catalog` 显示当前数字。
- 需要KAS？任何交易所或钱包都可以使用 — 存款是普通的L1转账。
---
`mcp-name: io.github.Kali123411/k402`
MIT © Kaspa Lab
