insumer について
insumerは、ブロックチェーンをまたいでウォレット条件を確認するMCPサーバーです。署名付きの合否証明を返し、独立検証向けの証明データも任意で提供します。
主な機能
- 01ウォレット条件の証明
- 0237チェーンに対応
- 03ECDSAと耐量子署名
- 04任意のEVM Merkle証明
- 05加盟店・トークンの検索
- 06署名付き割引コードの処理
活用シーン
- 01ウォレット条件によるアクセス制御
- 02API外での証明検証
- 03加盟店やトークンの検索
- 04割引コードの発行と検証
MCP 対応
InsumerAPIのセットアップ、ウォレット検証、ディレクトリ検索、コマース向けツールをMCPクライアントに公開します。ローカル実行と、ホスト型streamable HTTPエンドポイントに対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y mcp-server-insumerINSUMER_API_KEYシークレットInsumerAPI key (starts with insr_live_). Either this or INSUMER_PAYMENT_KEY.INSUMER_PAYMENT_KEYシークレットPrivate key of a throwaway Base wallet holding a little USDC, for pay-per-call via x402 when no API key is set. Each quote is checked before signing.INSUMER_MAX_PAYMENT_USDCMost USDC the server will pay for one call in pay-per-call mode (default 3).ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
27掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| proof | enum | いいえ | EIP-1186 Merkle 証明を取得するには 'merkle' を設定します(2 クレジット。証明が提供されない場合は 1 に返金)。ERC-20 に対する token_balance または ratio_to_amount では、残高スロットのストレージ証明を使用します(subject フィールドなし)。同じ条件で contractAddress が 'native' の場合は、評価値を balance フィールドに含むアカウント証明(subject 'account_balance')を使用します。account_code では、評価値を codeHash に含むアカウント証明(subject 'account_code')を使用します。erc7710_delegation では、オンチェーンでレイアウトが検証されたマネージャー上の失効スロットのストレージ証明(subject 'delegation_revocation')を使用します。EVM チェーンのみ対応(ZKsync Era、Sei、Viction、XDC Network、および非 EVM チェーンには非対応)。merkle |
| format | enum | いいえ | レスポンスにWallet Auth by InsumerAPIトークン(ES256署名のJWT)を含め、その横にML-DSA-65対応のpqJwtを含めるには、'jwt'に設定します。jwtは、/.well-known/jwks.jsonのJWKSを使用して、標準的なJWTライブラリで検証できます。jwt |
| wallet | string | いいえ | EVMウォレットアドレス(0x...) |
| suiWallet | string | いいえ | Suiウォレットアドレス(0x + 64個の16進数文字)。SUIまたはその他のSuiコイン(例:USDC)の検証に使用します。chainId 'sui'を使用し、Suiコイン型をcontractAddressとして指定します。ネイティブSUIには'0x2::sui::SUI'、その他のコインには完全なcoin type address::module::Nameを指定します。Suiでは文字列'native'は受け付けられません。 |
| conditions | array | はい | 検証するオンチェーン条件(1~10件) |
| tronWallet | string | いいえ | Tronウォレットアドレス(Tで始まるbase58)。TRXまたはTRC20トークン(USDT-TRC20)の検証に使用します。chainId 'tron'を使用します。 |
| xrplWallet | string | いいえ | XRPLウォレットアドレス(r-address)。XRP、トラストラインのトークン(RLUSD、USDC)、またはXRP Ledger上のNFTを検証するために使用します。 |
| solanaWallet | string | いいえ | Solanaウォレットアドレス(base58) |
| bitcoinWallet | string | いいえ | Bitcoinアドレス(P2PKH、P2SH、bech32、またはTaproot)。ネイティブBTC残高の検証に使用します。chainId 'bitcoin'、contractAddress 'native'を使用します。 |
| stellarWallet | string | いいえ | Stellar ウォレットアドレス(G で始まる)。XLM またはトラストライン資産(USDC、BENJI など)の検証に使用します。chainId 'stellar' を使用し、資産発行者の G アドレスを contractAddress として指定して、assetCode(例:'USDC')を渡します。Soroban コントラクトの残高は参照できません。クラシックトラストラインのみ対応します。 |
| declaredLimits | enum | いいえ | erc7710_delegation条件の署名済み結果からデコード済みのcaveat制限を除外するには、'omit'に設定します。これにより、転送された証明に委任者の支出上限が含まれなくなります。met、delegationHash、conditionHashは設定にかかわらずバイト単位で同一です。omit |
詳細
mcp-server-insumer
InsumerAPI用のMCPサーバーです。条件ベースのアクセスインフラを提供します。ウォレットと条件を送信すると、37のチェーンに対応した署名済みの真偽値を取得できます。残高は公開されず、本人確認も不要です。結果はすべて署名されており、公開鍵を使ってオフラインで検証できます。EVMチェーンでは、オプションのMerkle証明を使うことで、APIを信頼することなく、検証者がブロックヘッダーに照らして残高を確認できます。
AI エージェント(Claude Desktop、Cursor、Windsurf、およびMCP互換のあらゆるクライアント)が、オンチェーン条件の検証、加盟店の検索、署名済み割引コードの生成、新規加盟店の登録を通じて、あらゆるワークフローに条件ベースのアクセスを追加できるようにします。
本番環境での利用例: ライセンスを持つEUパートナーを通じて決済を行う、ノンカストディアルな決済オーケストレーターAsterPayは、稼働中のERC-8183エージェント型コマースの信頼性チェックにInsumerAPIのアテステーションを使用しています。導入事例。
以下でも利用できます:LangChain(26個のツール、PyPI) | ElizaOS(10個のアクション、npm) | OpenAI GPT(GPT Store) | insumer-verify(クライアント側検証、npm)
AIエージェント検証APIの完全ガイド:37のチェーン、信頼プロファイル、コマースプロトコル、署名検証について解説しています。
クイックスタート
Claude Desktop
claude_desktop_config.jsonに追加します:
{
"mcpServers": {
"insumer": {
"command": "npx",
"args": ["-y", "mcp-server-insumer"],
"env": {
"INSUMER_API_KEY": "insr_live_..."
}
}
}
}
Cursor / Windsurf
MCP設定に追加します:
{
"insumer": {
"command": "npx",
"args": ["-y", "mcp-server-insumer"],
"env": {
"INSUMER_API_KEY": "insr_live_..."
}
}
}
キーの取得:メールアドレスのみで、ダッシュボードやパスワードは不要
3つの方法があり、いずれも数秒で利用可能なinsr_live_...キーを取得できます。無料の検証10回と、1日あたり100件のリクエストが含まれます。無料キーはメールアドレス1件につき1つです。
方法A:エージェントに取得させる。 キーを指定せずにサーバーを起動します。AI エージェントは、メールアドレスを指定してinsumer_setupツールを呼び出すことで、すぐに無料キーを生成できます。設定に追加して、再起動してください。
方法B:ターミナル。
curl -s -X POST https://api.insumermodel.com/v1/keys/create \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "appName": "MCP Server", "tier": "free"}'
方法C:ブラウザー。 insumermodel.comでメールアドレスを入力すると、キーがその場に表示されます。
設定でINSUMER_API_KEYとして指定します。
すでにキーをお持ちですか? insumermodel.com/developers/account/で利用状況の確認、チャージ、プランのアップグレードができます。
オプション D:x402 で呼び出しごとに支払う(キー不要)
キーの代わりに、数ドル分の USDC を入金した使い捨ての Base ウォレットを INSUMER_PAYMENT_KEY に設定します。従量制の呼び出し(insumer_attest、insumer_wallet_trust、insumer_batch_wallet_trust)は、x402 を介してその場で支払われます。サーバーが料金をリクエストし、Base 上で EIP-3009 の USDC 承認に署名してから再試行します。サインアップも、クレジットも、ダッシュボードも不要です。
{
"mcpServers": {
"insumer": {
"command": "npx",
"args": ["-y", "mcp-server-insumer"],
"env": { "INSUMER_PAYMENT_KEY": "0x<throwaway-wallet-private-key>" }
}
}
}
- Base の USDC のみ対応しています。ウォレットには USDC が必要ですが、ETH は不要です(決済にガス代はかかりません)。
- 各呼び出しの費用は数セントです(attest は $0.05、trust は $0.15)。少額を入金した専用の使い捨てウォレットを使用し、まとまった資金を保有するウォレットは絶対に使用しないでください。
- ウォレットが署名する前に、すべての見積もりを確認します。 サーバーが支払うのは InsumerAPI 自身の受取アドレス(
0xee432065474D2C852700f74e3fD81e2Bcc16a3D4、または 2026-10-19 より前に提示されたアドレス0xAd982CB19aCCa2923Df8F687C0614a7700255a23)宛てで、Base 上の USDC に限られます。また、上限(デフォルトでは1 回の呼び出しにつき $3.00。現在最も高額な呼び出しである、Merkle 証明を使用した 10 ウォレットの trust バッチの料金)を超えることはありません。それ以外はすべて拒否され、署名も行われません。上限を変更するには、INSUMER_MAX_PAYMENT_USDCを設定します。たとえば、attest のみを使う場合は"0.25"を指定します。最も安価な呼び出しは $0.05 のため、それより低い上限では有料の呼び出しがすべて拒否されます(サーバー起動時に警告が表示されます)。不正な値を指定すると、デフォルトにフォールバックせず、呼び出しごとの支払いが無効になります。 INSUMER_API_KEYとINSUMER_PAYMENT_KEYの両方が設定されている場合は、キー(クレジット)が使用されます。
ホスト型エンドポイント(インストール不要)
同じサーバーが MCP のストリーミング可能な HTTP を介して https://api.insumermodel.com/mcp で実行されます。URL で接続するクライアント(ChatGPT プラグインや開発者モードのコネクター、claude.ai のカスタムコネクター、npm パッケージを実行できないホスト型エージェントプラットフォーム)向けです。URL を貼り付けるだけで、設定は不要です。
このエンドポイントは共有型で匿名のため、呼び出し元の識別情報がなくても利用できる 10 個のツール(署名鍵、attest、コンプライアンステンプレート、ウォレット trust とバッチ trust、加盟店とトークンのディレクトリ、無料の割引チェック、コード検証)を提供します(HOSTED_TOOLS)。従量制ツールは、1 つの無料日次利用枠を共有します。利用枠を超えると、ここへの案内とともに呼び出しが拒否されます。独自の利用枠、キーとクレジットの管理、または加盟店ツールを利用するには、上記のように自分のキーを使ってパッケージをローカルで実行してください。
サーバーを自分でホストするには、ビルドして INSUMER_API_KEY を設定した状態で node build/http.js を実行します(PORT、INSUMER_HOSTED_TOOLS、INSUMER_DAILY_CAP は任意です)。または、パッケージのルートから createInsumerServer(options) を呼び出して組み込みます。これにより、任意のトランスポート向けに設定済みのサーバーが返されます。
返される内容
エージェントが 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",
"operator": "gte",
"threshold": "1000",
"type": "token_balance"
},
"conditionHash": "0x8a3b...",
"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": "NgA7BO8SAildiTrgIQY2UyXsBrySZknkP85pT2Zqv8Hq0KsCsB8DRFVMkXgnXtCXrbb726Is6k4LyyBYU+f/Pw==",
"kid": "insumer-attest-v2",
"pqSig": "<base64 ML-DSA-65 signature>",
"pqKid": "insumer-attest-pq1"
},
"meta": {
"version": "1.0",
"timestamp": "2026-02-28T12:34:57.000Z",
"creditsRemaining": 99,
"creditsCharged": 1
}
}
sig は ECDSA P-256 署名(base64、P1363 r||s、88 文字)です。kid は鍵を識別し、署名対象のバイト列を選択します。insumer-attest-v2 は "insumer.attestation.v2\n" + canonical_json({v: 2, id, pass, results, attestedAt}) に署名します(各階層でキーをソート)。insumer-attest-v1 は {id, pass, results, attestedAt} の JSON.stringify の結果そのものに、挿入順で署名します。すべての attest および trust のレスポンスには、ES256 と耐量子 ML-DSA-65 署名の 2 種類が付与されます。pqSig と pqKid は、耐量子ドメインタグと、kid が選択するものと同じ従来の署名対象データに対する署名です。また、jwt と並んで pqJwt も付与されます。これらは sig と kid の隣に追加され、既存の値は変更されません。conditionHash は、評価された条件ロジックそのものを SHA-256 でハッシュ化した値です。
残高も、金額もありません。暗号署名された true/false だけです。
XRPL 条件の場合、結果には blockNumber/blockTimestamp の代わりに、ledgerIndex、ledgerHash(検証済みの台帳ハッシュ)、および trustLineState: { frozen: boolean } が含まれます。ネイティブ XRP 条件には ledgerIndex と ledgerHash が含まれますが、trustLineState は含まれません。凍結されたトラストラインは met: false になります。
ウォレット認証(JWT)
insumer_attest ツールのパラメーターに format: "jwt" を追加すると、証明を標準的な JWT ベアラートークンとして受け取れます。
{
"wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"conditions": [ ... ],
"format": "jwt"
}
レスポンスには、ES256 で署名された JWT を含む追加の jwt フィールドと、その隣に同じクレームを含む pqJwt フィールド(alg が ML-DSA-65 のコンパクトな JWS で、insumer-attest-pq1 で署名)が含まれます。jwt トークンは、GET /v1/jwks の JWKS エンドポイントを利用して、標準的な JWT ライブラリで検証できます。そのため、Kong、Nginx、Cloudflare Access、AWS API Gateway など、JWT ベアラートークンを受け付ける他のミドルウェアと互換性があります。
レスポンスの検証
エージェントは証明を取得します。アプリケーション側で検証してください。insumer-verify をインストールします(Python 用は PyPI から利用できます。pip install insumer-verify を実行してください。同じ検証項目に対応し、公開済みテストベクトルも同じ 27 件です)。
npm install insumer-verify
import { verifyAttestation } from "insumer-verify";
// attestationResponse = the full API envelope {ok, data: {attestation, sig, kid, pqSig, pqKid}, 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);
}
このツールは、ECDSA 署名、条件ハッシュの整合性、ブロックの鮮度、証明の有効期限、耐量子署名の 5 つを個別に判定します(insumer-verify 1.8.1 以降では、耐量子署名の結果は検証済み、否定、なし、検証不能のいずれかとして報告されます)。実行時の依存関係はなく、Web Crypto API を使用します。
ツール(27)
セットアップ(無料、認証不要)
| ツール | 説明 |
|---|---|
insumer_setup | 無料の API キーをすぐに生成します。メールアドレスを受け取り、無料の検証 10 回と 1 日あたり 100 リクエストが利用できる insr_live_... キーを返します。クレジットカードは不要です。 |
鍵の検出(無料)
| ツール | 説明 |
|---|---|
insumer_jwks | JWKS を取得します。2 つの鍵に対する 5 つのエントリーが含まれます。insumer-attest-v1、insumer-attest-v2、insumer-trust-v2 の ECDSA P-256 鍵に続き、RFC 9964 の AKP エントリー 2 つ(insumer-attest-pq1 と insumer-trust-pq1)に耐量子鍵 ML-DSA-65 が含まれます。位置ではなく、レスポンスの kid(または pqKid)で照合してください。 |
オンチェーン検証(クレジットを消費)
token_balanceのしきい値は10進数の文字列です。thresholdには100ではなく"100"を渡してください。2026-06-10以降に作成されたキーは、完全な精度を保持し、JSON数値を400で拒否するkid: insumer-attest-v2で署名します。insumer_attestツールは数値または文字列を受け付け、正規の文字列に変換します。古いinsumer-attest-v1キーでは、どちらも受け付けます。
| ツール | 説明 |
|---|---|
insumer_attest | オンチェーンの条件を検証します(トークン残高、NFTの所有権、EASアテステーション、Farcaster ID、任意のブール値を返すビュー関数用のevm_view_call、エージェント支出上限を自身の規模に合わせて調整するratio_to_amount、供給量に占める割合のルール用のratio_to_supply。これら3つはEVMのみです。また、ERC-8004エージェント登録用のerc8004_agentと、MetaMaskフレームワークの委任の有効性を検証するerc7710_delegationはBaseのみです。さらに、EVMチェーン上のウォレットアドレス自体のコード状態を確認するaccount_codeがあります。expectには、通常のキーアカウントならnone、EIP-7702委任デジグネーターならeip7702(任意で特定のdelegateを指定)、その他のコードならcontractを指定します。結果は条件を満たすか満たさないかで返され、コードと委任先は返されません)。kid、evaluatedCondition、conditionHash(SHA-256)、blockNumber/blockTimestampを含む、ECDSA署名付きの真偽値を返します。1クレジット。EIP-1186 Merkle証明には、任意のproof: "merkle"を指定できます(2クレジット)。トークン残高には残高スロットのストレージ証明、ネイティブコインにはアカウント証明(subject account_balance)、account_codeにはアカウント証明(subject account_code)、erc7710_delegationには失効スロット証明(subject delegation_revocation)が使われます。 |
insumer_compliance_templates | 利用可能なEASコンプライアンステンプレート(BaseのCoinbase Verifications、OptimismのGitcoin Passport)を一覧表示します。無料です。 |
insumer_wallet_trust | ECDSA署名付きのウォレット信頼性ファクトプロファイルを生成します。10のディメンション(ステーブルコイン、ガバナンス、NFT、ステーキング、機関向けステーブルコイン、トークン化国債、ステーブルコイン預金、ラップドビットコイン、ネーム、アカウント)で、27チェーンにわたる155件の基本チェックを実行します。Solana、XRPL、Bitcoin、Tronのウォレットを任意で指定すると、14のディメンション、29チェーンにわたる最大176件のチェックを実行できます(StellarとSuiのウォレットを指定すると、基本ディメンション内の行が切り替わります)。すべてのチェックは存在確認です。アカウントディメンションでは、チェーンごとに2つの行(コントラクトコード、EIP-7702委任)があり、Ethereum、Base、Arbitrum、Optimism、Polygonで、存在するかどうかを確認します。ディメンションは固定順で返されます。まず記載順の基本ディメンションが続き、その後、有効にしたsolana、xrpl、bitcoin、tronが続きます。署名付きのconditionSetVersion(現在は2026-10-08)はチェックリストを示します。記録してください。これを理由に拒否しないでください。3クレジット(merkle付きでは6クレジット。証明が返されない場合は、追加料金が常に返金されます)。 |
insumer_batch_wallet_trust | 最大10個のウォレットの信頼性プロファイルをまとめて生成します。各ウォレットオブジェクトでは、solanaWallet、xrplWallet、bitcoinWallet、tronWallet、stellarWallet、suiWalletを任意で指定できます。逐次呼び出しより高速です。一部の処理だけ成功する場合もあります。1ウォレットあたり3クレジット(merkle付きでは6クレジット)。デフォルトでは、テキストにウォレットごとの概要が表示されます(すべてのウォレットでディメンションの順序は固定で同一です。アカウントディメンションのチェックは、保有ではなく存在を確認します)。完全な署名付きプロファイルはstructuredContentに含まれます。detail: "full"を指定すると、テキストにも表示されます(プロファイルは再取得できないため、呼び出し時に指定してください)。 |
insumer_verify | マーチャントでウォレットに使える、署名付き割引コード(INSR-XXXXX、有効期限30分)を作成します。割引が適用されるコードには、ストアを所有するAPIキーから1クレジットが課金されます。割引率0%の場合は無料です。別のキーを使う呼び出し元には課金されません。任意のwalletProofで、EVMウォレットを管理していることを証明できます。割引は全額適用され、1日の上限はありません。 |
ディスカバリー(無料)
| ツール | 説明 |
|---|---|
insumer_list_merchants | 加盟店ディレクトリを閲覧します。トークンや認証ステータスで絞り込めます。 |
insumer_get_merchant | 加盟店の公開プロフィール全体を取得します。 |
insumer_list_tokens | Insumer レジストリに登録されているトークンと NFT を一覧表示します。チェーン、シンボル、種類で絞り込めます。これはディレクトリであり、検証可能な対象の一覧ではありません。アテステーションでは、対応チェーン上のあらゆるトークンと、EVM チェーン、Solana、XRPL 上の NFT を検証できます。 |
insumer_check_discount | 加盟店におけるウォレットの割引額を計算します。 |
クレジットとキー
| ツール | 説明 |
|---|---|
insumer_buy_key | USDC で新しい API キーを購入します(認証不要)。エージェントが使いやすい設計です。メールアドレスは不要で、送金ウォレットがキーの識別情報となり、支払い内容を記載した固定テキストに署名します(senderSignature。これを指定せずに呼び出すと、テキストが返されます)。ウォレットごとにキーは 1 つです。amount は必須で、最低額は $5 です。ボリューム割引により、1 回あたり $0.04~$0.02 になります。対応チェーン:Ethereum、Base、Polygon、Arbitrum、Optimism、BNB Chain、Avalanche、Solana。返金不可です。 |
insumer_credits | クレジット残高とティアを確認します。 |
insumer_buy_credits | USDC で検証クレジットを購入します。amount は必須で、最低額は $5 です。ボリューム割引により、1 回あたり $0.04~$0.02 になります。対応チェーン:Ethereum、Base、Polygon、Arbitrum、Optimism、BNB Chain、Avalanche、Solana。返金不可です。初回購入時に送金ウォレットが登録されます。2 回目以降の購入は、登録済みウォレットから行うか、updateWallet: true を指定する必要があります。ウォレットの登録または変更には、支払いを送金したウォレットの senderSignature が必要です。 |
insumer_confirm_payment | 割引コードの USDC 支払いを確認します。 |
加盟店の登録(オーナー限定)
| ツール | 説明 |
|---|---|
insumer_create_merchant | 新しい加盟店を作成します。作成したキーがオーナーになります。加盟店自体には残高がなく、コード、スキャン、タップの費用はそのキーが支払います。 |
insumer_merchant_status | 加盟店の非公開情報全体を取得します。 |
insumer_configure_tokens | トークンの割引ティアを設定します。割引率は 1~50 の整数です。トークンには表示用の name と logo を設定でき、自社トークンには enabled を設定します。 |
insumer_configure_nfts | NFT コレクションを設定します。割引率は 1~50 の整数、または認識のみを示す benefitType: "recognition" を指定します。enabled: false にすると、コレクションは無効のままになります。 |
insumer_configure_settings | 割引モード、上限、保有を証明できないウォレットに適用する条件、USDC 支払いを設定します。 |
insumer_publish_directory | 加盟店を公開ディレクトリに掲載します。 |
insumer_buy_merchant_credits | 互換性維持のために残されています。店舗自体には残高がありません。ここで送信した USDC 支払いは、店舗を所有する API キーに通常のクレジットとして追加されます。レートは $1 あたり 25 クレジット固定です(insumer_buy_credits にはボリュームティアがあります)。amount は必須で、最低額は $5 です。オーナーのみ利用できます。返金不可です。初回購入時に送金ウォレットが登録されます。2 回目以降の購入は、登録済みウォレットから行うか、updateWallet: true を指定する必要があります。ウォレットの登録または変更には、支払いを送金したウォレットの senderSignature が必要です。 |
ドメインの検証(オーナー限定)
| ツール | 説明 |
|---|---|
insumer_request_domain_verification | 加盟店のドメインの検証トークンをリクエストします。トークンと 3 つの方法(DNS TXT、メタタグ、ファイルのアップロード)が返されます。 |
insumer_verify_domain | トークンを配置した後、ドメインの検証を完了します。検証済みの加盟店には信頼バッジが付与されます。 |
コマースプロトコルの統合
| ツール | 説明 |
|---|---|
insumer_acp_discount | OpenAI/Stripe ACP 形式で割引の適用資格を確認します。クーポンオブジェクトと商品ごとの割り当てを返します。割引が適用されるコードを使用すると、ストアの所有者キーに1クレジットが課金されます。割引率が0%の場合は無料です。別のキーを使用する呼び出し元には課金されません。 |
insumer_ucp_discount | Google UCP 形式で割引の適用資格を確認します。タイトル、拡張フィールド、適用済み配列を返します。割引が適用されるコードを使用すると、ストアの所有者キーに1クレジットが課金されます。割引率が0%の場合は無料です。別のキーを使用する呼び出し元には課金されません。 |
insumer_validate_code | INSR-XXXXX 割引コードを検証します。有効性、割引率、有効期限を返します。無料で、認証は不要です。 |
料金
プラン: Free(無料の検証10回と1日あたり100リクエスト) | Pro $29/mo(毎月1,000クレジット、1日あたり10,000回) | Enterprise $99/mo(毎月5,000クレジット、1日あたり100,000回)
ボリューム割引: $5–$99 = 1回あたり$0.04($1あたり25クレジット) · $100–$499 = $0.03($1あたり33クレジット、25%割引) · $500以上 = $0.02($1あたり50クレジット、50%割引)
キーとクレジットの購入に使えるのはUSDCのみです。 受取アドレス:
- Ethereum、Base、Polygon、Arbitrum、Optimism、Avalanche上のUSDC:
0xee432065474D2C852700f74e3fD81e2Bcc16a3D4 - BNB Chain上のUSDC:
0xAd982CB19aCCa2923Df8F687C0614a7700255a23(切り替え期間中は、他のEVMチェーンからこのアドレスに送金されたUSDCも受け付けます) - Solana上のUSDC:
8fyEGM5tRjMocKQWaVXyM2XvvnTxR3sWdrYtug2zeLX4(切り替え期間中は、6a1mLjefhvSJX1sEX8PTnionbE9DqoYjU6F6bNkT4YdrへのUSDC送金も受け付けます)
対応する決済チェーン: Ethereum、Base、Polygon、Arbitrum、Optimism、BNB Chain、Avalanche、Solana。USDTおよびその他のトークンは受け付けず、クレジットも付与されません。未対応のチェーンで送金されたトークンは復元できません。購入はすべて最終的なもので、払い戻しはできません。料金の詳細 →
送信者の署名。 キーをウォレットに紐付ける購入(すべてのキー購入、登録済みウォレットのないキーでのクレジット購入、または別のウォレットからのupdateWallet: true)では、senderSignatureが必要です。支払いを送信したウォレットが、末尾の改行なしで\nにより結合した次の5行のテキストに署名します。
api.insumermodel.com
Confirm the wallet that sent this payment.
Purpose: key purchase
Chain: eip155:8453
Transaction: 0x<transaction hash, lowercase hex>
クレジット購入の場合、Purposeはcredit purchaseです。EVMチェーンではChainはeip155:<chainId>、Solanaではsolanaです(Solanaの署名は指定どおり)。senderSignatureなしで一度呼び出すと、400エラーで正確なテキストが返されます。EVMウォレットはpersonal_sign(EIP-191、0x形式の16進数)で署名します(スマートウォレットはERC-1271で検証されます)。SolanaウォレットはsignMessage(ed25519、base58またはbase64)で署名します。403エラーは、支払いを送信したウォレットによる署名ではないことを示します。503エラーはスマートウォレットの確認を完了できず、支払いが使用されなかったことを示します。
rpc_failure エラーの処理
再試行後もAPIが1つ以上のブロックチェーンデータソースに到達できない場合、insumer_attest、insumer_wallet_trust、insumer_verify、insumer_acp_discount、insumer_ucp_discount、insumer_check_discountは、エラーコードrpc_failureとともにok: falseを返します。署名もJWTもなく、クレジットも課金されません。insumer_batch_wallet_trustは通常どおり応答し、署名済みのウォレットと並べて、読み取りが完了しなかったウォレットごとにerrorエントリを含めます。これは再試行可能なエラーです。MCP クライアントは短時間(2~5秒)待ってから再試行してください。
重要: rpc_failureは検証失敗ではありません。pass: falseとして扱わないでください。データソースが一時的に利用できず、未検証の結果への署名をAPIが拒否したことを意味します。
対応チェーン(37)
EVMチェーン31種 + Solana + XRP Ledger + Bitcoin + Tron + Stellar + Sui。Ethereum、Base、Polygon、Arbitrum、Optimism、BNB Chain、Avalanche、XDC、Robinhood Chain、Arc、およびその他21種のEVMチェーンが含まれます。一覧を見る →
こちらも利用できます
- Claude Code Skill:
git clone https://github.com/insumerapi/insumer-skill.git ~/.claude/skills/insumer(GitHub · Smithery)。Claude Code 内から、自分のプロジェクトにウォレット認証を実装するためのものです。この MCP サーバーはエージェントに実行時の API アクセスを提供し、insumer-skill は開発者がビルド時に統合コードを作成するのを支援します。利用方法は異なりますが、基盤となる仕組みは同じです。 - ElizaOS プラグイン:
@insumermodel/plugin-eliza(npm) - LangChain(Python):
pip install langchain-insumer(PyPI) - OpenAI GPT: InsumerAPI Wallet Auth(GPT Store)
- Verifier(オフライン JWKS):
npm install insumer-verify(npm、ソース)
開発
npm install
npm run build
# Test with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。