MCP（AI Agent 接入）

为什么是 MCP？

MCP（Model Context Protocol）是连接 AI agent 与外部工具的开放协议。BoltTx 是 Solana 交易投递赛道首家原生提供 MCP server 的服务 —— 这意味着你的 AI agent 无需写任何粘合代码，就能查账户、查 tip 最低值、提交已签名交易。

前置条件

• 安装 Node.js 18+（用 `node --version` 确认）
• 任意 MCP 兼容的 AI agent

在你的 MCP 客户端配置里加一段 JSON 即可。MCP 兼容的 AI agent 第一次调用 BoltTx 工具时会自动通过 `npx` 拉起 server。

{
  "mcpServers": {
    "bolttx": {
      "command": "npx",
      "args": ["-y", "@bolttx/mcp-server"],
      "env": {
        "BOLTTX_API_KEY": "btx_live_your_api_key_here"
      }
    }
  }
}

npm install -g @bolttx/mcp-server

{
  "mcpServers": {
    "bolttx": {
      "command": "bolttx-mcp-server",
      "env": {
        "BOLTTX_API_KEY": "btx_live_your_api_key_here"
      }
    }
  }
}

可用工具

这些是 AI agent 看到的工具名。Agent 会根据你的自然语言请求自动决定调哪个。

资源

Agent 在需要背景信息时主动拉取的只读上下文。回答「我是什么套餐？」、「最低 tip 多少？」这类问题无需走网络。

当你对 AI 说「用 BoltTx 发 0.1 SOL 给 X，最低 tip」时，agent 内部按这个顺序走：

1. 1

   调 `bolttx_get_my_account` → 知道你的套餐（例如 Growth）

2. 2

   调 `bolttx_get_tip_amount("growth")` → 拿到最低 tip 的 lamports

3. 3

   调 `bolttx_list_tip_addresses` → 选 9 个 tip 地址中的一个

4. 4

   本地构造交易（你的指令 + 给 tip 地址的 SystemProgram transfer）

5. 5

   本地用你的 keypair 签名（私钥永远不接触 MCP server）

6. 6

   调 `bolttx_send_transaction(base64)` → 拿到签名

7. 7

   （可选）稍等后调 `bolttx_get_status(signature)` → 确认上链

兼容性

任何兼容 MCP 的客户端都能用 —— 协议本身是标准化的，配置格式跨厂商完全统一。每家客户端的具体配置文件路径见 npm 上的 @bolttx/mcp-server README，新 MCP 客户端上线时我们会同步更新该文档。