MCP Server Insumer

mcp服务器用户

MCP服务器 错误 --基于条件的接入基础设施。发送钱包和条件，在37条链上获得一个签名的布尔值。不暴露余额，不需要身份，不需要对API提供商的信任。

使人工智能代理（Claude Desktop、Cursor、Windsurf和任何兼容MCP的客户端）能够向任何工作流添加基于条件的访问权限——验证链上条件、发现商家、生成签名的折扣码和加入新商家。

完整人工智能代理验证API指南 --涵盖了所有37个链、信任配置文件、商务协议和签名验证。

快速开始

克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "insumer": {
      "command": "npx",
      "args": ["-y", "mcp-server-insumer"],
      "env": {
        "INSUMER_API_KEY": "insr_live_..."
      }
    }
  }
}

光标/风帆

添加到MCP设置中：

{
  "insumer": {
    "command": "npx",
    "args": ["-y", "mcp-server-insumer"],
    "env": {
      "INSUMER_API_KEY": "insr_live_..."
    }
  }
}

获取API密钥

选项A——让你的代理人来做： 在没有密钥的情况下启动服务器。您的AI代理可以呼叫 insumer_setup 使用您的电子邮件工具立即生成免费密钥。将其添加到您的配置中并重新启动。

选项B——终端（无需浏览器）：

curl -s -X POST https://api.insumermodel.com/v1/keys/create \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "appName": "MCP Server", "tier": "free"}'

返回一个 insr_live_... 密钥具有100次读取/天和10个验证信用。每封电子邮件一个免费密钥。

选项C——浏览器： 首选 insumermodel.com/developers 并立即生成免费密钥。

设置为 INSUMER_API_KEY 在您的配置中。

你得到了什么

当你的经纪人来电时 insumer_attest，您将获得ECDSA签名的证明：

{
  "ok": true,
  "data": {
    "attestation": {
      "id": "ATST-A7C3E1B2D4F56789",
      "pass": true,
      "results": [
        {
          "condition": 0,
          "met": true,
          "label": "USDC >= 1000 on Ethereum",
          "type": "token_balance",
          "chainId": 1,
          "evaluatedCondition": {
            "chainId": 1,
            "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "decimals": 6,
            "operator": "gte",
            "threshold": 1000,
            "type": "token_balance"
          },
          "conditionHash": "0x554251734232c8b43062f1cf2bb51b76650d13268104d74c645f4893e67ef69c",
          "blockNumber": "0x1799043",
          "blockTimestamp": "2026-03-26T20:04:23.000Z"
        }
      ],
      "passCount": 1,
      "failCount": 0,
      "attestedAt": "2026-02-28T12:34:57.000Z",
      "expiresAt": "2026-02-28T13:04:57.000Z"
    },
    "sig": "dmNJKqnGZ9f47qpWax9gxgw1DhUKHKHrbLspTop8NWzYhv2fNpVAt1gAuhUfU4xPsgXTCdrmTXI4vEE50dcfEA==",
    "kid": "insumer-attest-v1"
  },
  "meta": {
    "version": "1.0",
    "timestamp": "2026-02-28T12:34:57.000Z",
    "creditsRemaining": 99,
    "creditsCharged": 1
  }
}

这 sig 是ECDSA P-256签名 {id, pass, results, attestedAt}The kid 标识签名的密钥 conditionHash 是所评估的精确条件逻辑的SHA-256。

没有余额。没有金额。只是一个加密签名的真/假。

对于XRPL条件，结果包括 ledgerIndex, ledgerHash （经过验证的分类账哈希），以及 trustLineState: { frozen: boolean } 而不是 blockNumber/blockTimestamp原生XRP条件包括 ledgerIndex 和 ledgerHash 但不是 trustLineState.冻结的信任线导致 met: false.

钱包认证（JWT）

添加 format: "jwt" 到 insumer_attest 用于接收作为标准JWT承载令牌的证明的工具参数：

{
  "wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "conditions": [ ... ],
  "format": "jwt"
}

该回复还包括 jwt 包含ES256签名JWT的字段。此令牌可由任何标准JWT库通过JWKS端点进行验证 GET /v1/jwks -使其与Kong、Nginx、Cloudflare Access、AWS API网关和其他接受JWT承载令牌的中间件兼容。

验证响应

你的代理人会得到证明。您的应用程序应该验证它。安装 用户验证:

npm install insumer-verify

import { verifyAttestation } from "insumer-verify";

// attestationResponse = the full API envelope {ok, data: {attestation, sig, kid}, meta}
// Do NOT pass attestationResponse.data — the function expects the outer envelope
const result = await verifyAttestation(attestationResponse, {
  jwksUrl: "https://insumermodel.com/.well-known/jwks.json",
  maxAge: 120, // reject if block data is older than 2 minutes
});

if (result.valid) {
  // Signature verified, condition hashes match, not expired
  const pass = attestationResponse.data.attestation.pass;
  console.log(`Attestation ${pass ? "passed" : "failed"} all conditions`);
} else {
  console.log("Verification failed:", result.checks);
}

这将运行4个独立的检查：ECDSA签名、条件哈希完整性、块新鲜度和证明到期。零运行时依赖，使用Web Crypto API。

工具（27）

安装程序（免费，无身份验证）

密钥发现（免费）

链上验证（成本信用）

探索（免费）

学分和密钥

商户登机（仅限车主）

域验证（仅限所有者）

商务协议集成

定价

层级： 免费（100次/天，10学分）|专业版29美元/月（1000学分/月，10000学分/天）|企业版99美元/月

批量折扣： 5美元-99美元=0.04美元/次（25学分/1美元）·100美元-499美元=0.03美元（33/1美元，25%折扣）·500美元+=0.02美元（50/1美元，50%折扣）

平台钱包：

• EVM（USDC/USDT）： 0xAd982CB19aCCa2923Df8F687C0614a7700255a23
• 索拉纳（美元/美元）： 6a1mLjefhvSJX1sEX8PTnionbE9DqoYjU6F6bNkT4Ydr
• 比特币： bc1qg7qnerdhlmdn899zemtez5tcx2a2snc0dt9dt0

支持的支付链： 以太坊、Base、Polygon、Arbitrum、乐观主义、BNB链、雪崩、Solana、比特币。在不受支持的链上发送的令牌无法恢复。所有购买均为最终决定，不可退款。 全价→

处理 rpc_failure 错误

如果API在重试后无法访问一个或多个区块链数据源，则生成签名证明的端点(insumer_attest, insumer_trust, insumer_trust_batch)返回 ok: false 带有错误代码 rpc_failure.没有签名，没有JWT，不收取学分。这是一个可重试的错误——MCP客户端应在短暂延迟（2-5秒）后重试。

重要提示： rpc_failure 不是验证失败。不要把它当作 pass: false。这意味着数据源暂时不可用，API拒绝签署未经验证的结果。

支撑链（37）

31个EVM链+Solana+XRP分类账+比特币+Tron+Stellar+Sui。包括以太坊、Base、Polygon、Arbitrum、乐观主义、BNB链、雪崩、XDC和另外23个EVM。 完整列表→

也可用作

• 克劳德代码技能： smithery skill add douglasborthwick/insumer-skill (史密瑟里 · )--为 *写作* 从Claude Code内部将钱包身份验证到您自己的项目中。该MCP服务器向代理运行时提供对API的访问；insumer技能帮助开发人员在构建时编写集成代码。不同的曲面，相同的图元。
• Elizaos插件： @insumermodel/plugin-eliza ()
• 语言链（Python）： pip install langchain-insumer (PyPI)
• OpenAI GPT： GPT商店
• 验证器（离线JWKS）： npm install insumer-verify ()

发展

npm install
npm run build

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js

许可证

麻省理工学院

______________________________________________________________________