hogswap-mcp

Name: hogswap-mcp
Author: LiquiHog

远程服务

github.com/LiquiHog金融数据011 周前更新

代码仓库

关于 hogswap-mcp

这是面向 HOGSWAP 的 MCP 服务，提供 Algorand DEX 报价、未签名交换交易构建和 x402 账单支付。它返回未签名交易，由用户使用自己的钱包工具签名并提交。

主要功能

01聚合 DEX 交换报价
02构建未签名交换交易
03使用持有的资产支付 x402 账单
04无需人工介入即可注册 API 密钥
05创建和管理价格监控

适用场景

01比较 Algorand 交换路径
02准备交易并交由钱包工具签名
03支付以 Algorand 结算的 x402 账单
04跟踪服务端价格或目标提醒

MCP 相关

它通过 stdio 或远程 Streamable HTTP 向 MCP 客户端提供 12 个工具。生成交易的工具返回未签名交易组；签名和提交在服务端之外完成。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://hogswap-v1.liquihog.dev/mcp/

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http liquihog-hogswap https://hogswap-v1.liquihog.dev/mcp/

Cursor.cursor/mcp.json{"mcpServers":{"liquihog-hogswap":{"type":"http","url":"https://hogswap-v1.liquihog.dev/mcp/"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"liquihog-hogswap":{"type":"http","url":"https://hogswap-v1.liquihog.dev/mcp/"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"liquihog-hogswap":{"type":"http","url":"https://hogswap-v1.liquihog.dev/mcp/"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"liquihog-hogswap":{"serverUrl":"https://hogswap-v1.liquihog.dev/mcp/"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npmhogswap-mcp0.4.0stdio

工具

此工具无需参数。

详细介绍

hogswap-mcp

将 HOGSWAP 提供给 AI Agent 使用的 MCP 服务：聚合 DEX 报价、构建未签名的兑换交易、无需人工的 API 密钥自助注册，以及明星工具——pay_x402_invoice：通过精确输出路由兑换，使用你持有的任意 1–4 种资产支付任何以 Algorand 结算的 x402 发票。API 参考文档： hogswap-v1.liquihog.dev/reference。如果你要构建应用而非 Agent，可使用官方 SDK： hogswap-js-sdk（npm）和 hogswap-py-sdk（PyPI）。

严格非托管：每个会生成交易的工具都会返回未签名的交易组；使用你自己的钱包工具签名并自行提交。绝不要向任何工具提供助记词或私钥。

运行（stdio）

npm install
HOGSWAP_API_KEY=hsk_... node src/index.mjs        # key optional

Claude Code：claude mcp add hogswap -e HOGSWAP_API_KEY=hsk_... -- node <abs-path>/src/index.mjs

环境变量	含义
`HOGSWAP_API_URL`	API 基础 URL（默认值为 `https://hogswap-v1.liquihog.dev`）
`HOGSWAP_API_KEY`	`hsk_` Bearer 密钥；可通过 `register_agent` / `verify_registration` 工具自行签发

工具

免费（无需密钥）：list_payable_assets、get_quote、register_agent、 verify_registration。get_quote 可选参数 max_legs（1–16）用于限制路由的总分段数（包括拆分）——适合在你自己的资源预算内重放路由。

🔑 以下工具需要 HOGSWAP API 密钥（设置 HOGSWAP_API_KEY，或通过 register_agent → 签名 → verify_registration 自行签发）：build_swap、 pay_x402_invoice、get_credit_offer、get_balance，以及监控工具 set_watch / list_watches / delete_watch（服务端持续监控价格或目标并发送提醒——免费，但按密钥隔离命名空间）。没有密钥时，这些工具会返回身份验证错误，而非构建结果。

监控触发时只会提供数字提示——触发后请使用 get_quote 重新获取报价。通过 MCP 使用时，轮询 list_watches；在 MCP 之外，服务端会通过 SSE 推送事件，地址为 GET /watches/stream。

pay_x402_invoice 会返回两个交易组（先兑换，后付款）——一次性签署所有交易，然后按顺序提交这些交易组；兑换交易的链上最低限额可确保付款资金充足。HOGSWAP 额度充值的 402 报价本身就是一张 x402 发票：将其 accepts[0]（连同 note nonce）直接传给 pay_x402_invoice，即可使用任意资产购买额度。

远程（无需本地进程）

同样的 12 个工具也通过 MCP Streamable HTTP 在 https://hogswap-v1.liquihog.dev/mcp/ 上提供——由 HOGSWAP API 本身托管，无需本地进程。请使用末尾带斜杠的地址——不带斜杠的 /mcp 会重定向（307）到 /mcp/，每次调用都会多一次往返。将任何支持远程连接的 MCP 客户端指向该地址；通过 Authorization: Bearer hsk_... 传入密钥（Claude API 连接器的 authorization_token 就是这样工作的）。

冒烟测试

HOGSWAP_API_KEY=hsk_... \
SMOKE_PAY_TO=<any USDC-opted addr> node test/smoke.mjs        # stdio

HOGSWAP_API_KEY=hsk_... \
SMOKE_PAY_TO=<any USDC-opted addr> node test/smoke-remote.mjs # remote

两者默认连接线上 API；设置 HOGSWAP_API_URL（stdio）或 MCP_URL（远程）即可将其指向其他实例。仅执行只读和构建操作；不会签名或广播任何内容。

支持 Markdown

登录后评论