Mazza Group AI APIs

mazzagrp-mcp

通过一个 MCP 端点调用来自 mazzagrp.com 的 23 个 AI API。 Agent 通过 x402 v2 / Base 主网 USDC 按次付费——无需 API 密钥、 无需注册，也无需订阅。

• Registry 名称：com.mazzagrp/mcp
• 远程端点：https://mazzagrp.com/mcp（可流式传输的 HTTP）
• 发现方式：/.well-known/x402.json · /.well-known/mcp/server-card.json · agents.md

使用远程服务（推荐）

无需安装。将客户端指向此 URL：

{
  "mcpServers": {
    "mazzagrp": {
      "type": "http",
      "url": "https://mazzagrp.com/mcp"
    }
  }
}

Claude Code：claude mcp add --transport http mazzagrp https://mazzagrp.com/mcp Cursor / Grok / 任何支持 URL 的客户端：粘贴 https://mazzagrp.com/mcp。

付款由客户端自己的钱包签名（x402 流程会返回包含要求的 402 响应； 客户端使用 Base 上的 USDC 完成结算）。远程服务 绝不会持有你的密钥。

使用 stdio 软件包（旧版，本地钱包）

pip install mazzagrp-mcp

{
  "mcpServers": {
    "mazzagrp": {
      "command": "mazzagrp-mcp",
      "env": { "MAZZAGRP_WALLET_KEY": "0xYOUR_PRIVATE_KEY" }
    }
  }
}

也可以使用钱包文件：MAZZAGRP_WALLET_PATH=/path/to/wallet.json （{"private_key": "0x...", "address": "0x..."}）。

注意： stdio 软件包提供 21 个工具，使用历史名称（recall、rag、 sql，……）。远程服务——也就是 registry 指向的服务——提供 23 个工具， 使用更明确的名称（knowledge_recall、rag_query、text_to_sql，……）。 底层 API 相同。新客户端请使用远程服务。

端点和价格

API 路径	价格（USDC）	功能
/api/ping	0.01	AI ping——一句话回答，端到端验证付款流程
/api/character	0.10	角色开发
/api/recall	0.20	记忆召回 / 上下文检索
/api/storyforge	0.60	创意故事创作
/api/design	0.80	设计建议
/api/temporal	0.80	Temporal.io 工作流设计
/api/puzzles	0.80	谜题和谜语生成
/api/chatbot	1.00	对话式 AI
/api/longqa	1.00	长篇问答
/api/sheets	1.00	电子表格公式和分析
/api/sql	1.20	SQL 生成和优化
/api/arena	1.20	大模型基准测试 / 比较
/api/autoflow	1.50	工作流编排
/api/rag	1.50	检索增强生成
/api/negotiator	1.50	谈判策略
/api/desktop	1.50	桌面应用开发指导
/api/webagent	1.80	自主网页 Agent
/api/simulation	2.00	场景模拟
/api/worldbuilder	2.00	小说和游戏世界构建
/api/mcp-eval	2.00	MCP 实现评估
/api/event-ops	2.50	活动运营（餐饮、企业活动、酒店服务）
/api/consultation	5.00	高级 AI 战略咨询
/api/automation	15.00	完整自动化工作流设计

权威数据源：/.well-known/x402.json （23 个端点，由 API 自身的端点表生成）。

支付方式

1. Agent 调用工具。
2. API 返回 HTTP 402，并附上 x402 v2 要求 （accepts[0].amount，网络 eip155:8453）。
3. 客户端使用自己的钱包签署 EIP-712 授权。
4. 客户端携带 PAYMENT-SIGNATURE 标头重试。
5. 返回响应——USDC 在 Base 上完成结算。

• 网络： Base 主网（eip155:8453）
• 资产： USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• 资金库： 0xD98b6969fab0bA4D4BB086fF273ff7CCD284CEe8

⚠️ 本 README 的旧版本写着“Base Sepolia（测试网）”。 这是错误的：该服务运行在 Base 主网 上。在 Sepolia 上充值的钱包无法支付任何费用。

免费演示

demo_free 无需付款即可返回一条真实的大模型回答，因此 Agent 可以在为钱包充值前验证完整流程。

许可证

MIT