InsumerAPI
InsumerAPI MCP server gives AI agents signed, privacy-preserving on-chain verification plus merchant/discount tooling across 37 chains.
Verify wallet conditions (
insumer_attest): evaluate 1–10 conditions (token balance, NFT ownership, EAS attestations, Farcaster ID, ERC-8004 agent, ERC-7710 delegation,evm_view_call,account_code, ratio checks) and get one ECDSA + ML-DSA-65 signed true/false attestation withconditionHash, block/ledger reference, optional JWT and optional Merkle proofs — no balances exposed.Wallet trust profiles (
insumer_wallet_trust,insumer_batch_wallet_trust): signed 155–176 presence checks across up to 29 chains in 10–14 dimensions, for one wallet or up to 10 in a batch.Get free API key (
insumer_setup): instantinsr_live_...key from an email, no signup or card.Fetch signing keys (
insumer_jwks): JWKS with ES256 and post-quantum ML-DSA-65 keys for offline verification.List compliance templates (
insumer_compliance_templates): pre-configured EAS schemas/attesters (Coinbase Verifications, Gitcoin Passport).Discover merchants and tokens (
insumer_list_merchants,insumer_get_merchant,insumer_list_tokens): public directory with filters and wallet terms.Discounts (
insumer_check_discount,insumer_verify,insumer_validate_code,insumer_acp_discount,insumer_ucp_discount,insumer_confirm_payment): free eligibility checks, INSR-XXXXX discount code creation (optional wallet proof via EIP-4361), code validation, and ACP/UCP-format checkout integrations.Credits and keys (
insumer_credits,insumer_buy_key,insumer_buy_credits): check balance/tier and register crypto payments (USDC/USDT/BTC/USDT-TRC20) for keys or credits.Merchant onboarding (owner-only):
insumer_create_merchant,insumer_merchant_status,insumer_configure_tokens,insumer_configure_nfts,insumer_configure_settings,insumer_publish_directory,insumer_buy_merchant_credits.Domain verification (owner-only):
insumer_request_domain_verificationandinsumer_verify_domainfor trust badges via DNS TXT, meta tag, or file.Error handling:
rpc_failure(503) means nothing was signed — retry, never treat it as a failed condition.
Supports on-chain verification of token balances and NFT ownership on the BNB Chain.
Enables verification of Coinbase Verifications and integration with the Coinbase ecosystem for agent wallet trust scoring.
Provides on-chain verification for token balances, NFT ownership, and other conditions on the Ethereum blockchain.
Allows verification of Farcaster identities and associated on-chain data.
Integrates with Google UCP (Universal Commerce Protocol) for discount eligibility and commerce applications.
Supports checking discount eligibility using the OpenAI ACP commerce protocol format.
Enables on-chain verification and access to compliance templates like Gitcoin Passport on the Optimism network.
Provides tools for verifying token balances and NFT ownership on the Polygon network.
Enables on-chain verification for token balances and wallet trust profiles on the Solana blockchain.
Supports checking discount eligibility using the Stripe ACP commerce protocol format.
Provides on-chain verification for native XRP, trust line tokens, and NFTs on the XRP Ledger (XRPL).
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
mcp-server-insumer
MCP server for InsumerAPI: condition-based access infrastructure. Send a wallet and conditions, get a signed boolean across 37 chains. No balances exposed, no identity required. Every result is signed and checkable offline against the published keys, and on EVM chains an optional Merkle proof lets the verifier check the balance against the block header without trusting the API.
Enables AI agents (Claude Desktop, Cursor, Windsurf, and any MCP-compatible client) to add condition-based access to any workflow: verify on-chain conditions, discover merchants, generate signed discount codes, and onboard new merchants.
In production: AsterPay, a non-custodial payments orchestrator settling through licensed EU partners, uses InsumerAPI attestations in its live ERC-8183 agentic-commerce trust checks. Case study.
Also available as: LangChain (26 tools, PyPI) | ElizaOS (10 actions, npm) | OpenAI GPT (GPT Store) | insumer-verify (client-side verification, npm)
Full AI Agent Verification API guide: covers all 37 chains, trust profiles, commerce protocols, and signature verification.
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"insumer": {
"command": "npx",
"args": ["-y", "mcp-server-insumer"],
"env": {
"INSUMER_API_KEY": "insr_live_..."
}
}
}
}Cursor / Windsurf
Add to your MCP settings:
{
"insumer": {
"command": "npx",
"args": ["-y", "mcp-server-insumer"],
"env": {
"INSUMER_API_KEY": "insr_live_..."
}
}
}Get a key: just an email, no dashboard, no password
Three paths, all give you a working insr_live_... key in seconds with 10 free verifications plus 100 requests a day. One free key per email.
Option A: let your agent do it. Start the server without a key. Your AI agent can call the insumer_setup tool with your email to generate a free key instantly. Add it to your config and restart.
Option B: terminal.
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"}'Option C: browser. Enter your email on insumermodel.com and the key appears inline.
Set it as INSUMER_API_KEY in your config.
Already have a key? Manage usage, top up, or upgrade at insumermodel.com/developers/account/.
Option D: pay per call with x402 (no key at all)
Instead of a key, set INSUMER_PAYMENT_KEY to a throwaway Base wallet funded with a few dollars of USDC. Metered calls (insumer_attest, insumer_wallet_trust, insumer_batch_wallet_trust) are then paid inline via x402: the server requests a price, signs an EIP-3009 USDC authorization on Base, and retries. No signup, no credits, no dashboard.
{
"mcpServers": {
"insumer": {
"command": "npx",
"args": ["-y", "mcp-server-insumer"],
"env": { "INSUMER_PAYMENT_KEY": "0x<throwaway-wallet-private-key>" }
}
}
}Base USDC only; the wallet needs USDC but no ETH (settlement is gasless).
Each call spends a few cents (attest $0.05, trust $0.15). Use a dedicated throwaway wallet funded with a small amount, never a wallet holding meaningful funds.
Every quote is checked before the wallet signs. The server pays only InsumerAPI's own receiving address (
0xee432065474D2C852700f74e3fD81e2Bcc16a3D4, or the address it quoted before 2026-10-19,0xAd982CB19aCCa2923Df8F687C0614a7700255a23), only in USDC on Base, and never more than the cap: $3.00 per call by default, the price of the largest call today (a 10-wallet trust batch with Merkle proofs). Anything else is refused and nothing is signed. SetINSUMER_MAX_PAYMENT_USDCto change the cap, e.g."0.25"if you only attest. The cheapest call is $0.05, so a cap below that refuses every paid call (the server warns at startup). A malformed value turns pay-per-call off rather than falling back to the default.If both
INSUMER_API_KEYandINSUMER_PAYMENT_KEYare set, the key (credits) is used.
Related MCP server: MolTrust
Hosted endpoint (no install)
The same server runs at https://api.insumermodel.com/mcp over MCP streamable HTTP, for clients that connect by URL: ChatGPT plugins and developer-mode connectors, claude.ai custom connectors, and hosted agent platforms that cannot run an npm package. Paste the URL; there is nothing to configure.
It is shared and anonymous, so it serves the ten tools that make sense without a caller identity (HOSTED_TOOLS: signing keys, attest, compliance templates, wallet trust and batch trust, the merchant and token directories, the free discount check, code validation), and the metered tools share one free daily allowance. Past it, a call is refused with a pointer here. For your own allowance, key and credit management, or the merchant tools, run the package locally with your key as above.
To host the server yourself, build it and run node build/http.js with INSUMER_API_KEY set (PORT, INSUMER_HOSTED_TOOLS and INSUMER_DAILY_CAP are optional), or embed it: createInsumerServer(options) from the package root returns a configured server for any transport.
What You Get Back
When your agent calls insumer_attest, you get an ECDSA-signed attestation:
{
"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
}
}The sig is an ECDSA P-256 signature (base64, P1363 r||s, 88 characters). The kid identifies the key and selects the signed bytes: insumer-attest-v2 signs "insumer.attestation.v2\n" + canonical_json({v: 2, id, pass, results, attestedAt}) (keys sorted at every level); insumer-attest-v1 signs the bare JSON.stringify of {id, pass, results, attestedAt} in insertion order. Every attest and trust response is signed twice: ES256 and a post-quantum ML-DSA-65 signature, pqSig and pqKid (over the post-quantum domain tag plus the same classical preimage the kid selects; pqJwt beside jwt), added beside sig and kid without changing them. The conditionHash is a SHA-256 of the exact condition logic that was evaluated.
No balances. No amounts. Just a cryptographically signed true/false.
For XRPL conditions, results include ledgerIndex, ledgerHash (validated ledger hash), and trustLineState: { frozen: boolean } instead of blockNumber/blockTimestamp. Native XRP conditions include ledgerIndex and ledgerHash but not trustLineState. Frozen trust lines cause met: false.
Wallet Auth (JWT)
Add format: "jwt" to the insumer_attest tool parameters to receive the attestation as a standard JWT bearer token:
{
"wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"conditions": [ ... ],
"format": "jwt"
}The response includes an additional jwt field containing an ES256-signed JWT, and beside it a pqJwt sibling (a compact JWS with alg ML-DSA-65 carrying the same claims, signed under insumer-attest-pq1). The jwt token is verifiable by any standard JWT library via the JWKS endpoint at GET /v1/jwks, which makes it compatible with Kong, Nginx, Cloudflare Access, AWS API Gateway, and other middleware that accepts JWT bearer tokens.
Verify the Response
Your agent gets the attestation. Your application should verify it. Install insumer-verify (also on PyPI for Python: pip install insumer-verify, same checks, same 27 published test vectors):
npm install insumer-verifyimport { 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);
}This reports five independent verdicts: ECDSA signature, condition hash integrity, block freshness, attestation expiry, and the post-quantum signature (insumer-verify 1.8.1+ reports it as verified, refuted, absent, or unverifiable). Zero runtime dependencies, uses Web Crypto API.
Tools (27)
Setup (free, no auth)
Tool | Description |
| Generate a free API key instantly. Takes an email, returns an |
Key Discovery (free)
Tool | Description |
| Get the JWKS: five entries over two keys. The ECDSA P-256 key under |
On-Chain Verification (cost credits)
token_balancethresholds are decimal strings. Passthresholdas"100", not100. Keys created from 2026-06-10 sign withkid: insumer-attest-v2, which preserves full precision and rejects a JSON number with a400. Theinsumer_attesttool accepts a number or string and coerces to the canonical string; olderinsumer-attest-v1keys accept either.
Tool | Description |
| Verify on-chain conditions (token balances, NFT ownership, EAS attestations, Farcaster identity, |
| List available EAS compliance templates (Coinbase Verifications on Base, Gitcoin Passport on Optimism). Free. |
| Generate ECDSA-signed wallet trust fact profile. 155 base checks across 27 chains in 10 dimensions (stablecoins, governance, NFTs, staking, institutional stablecoins, tokenized treasuries, stablecoin deposits, wrapped bitcoin, names, account), up to 176 checks across 29 chains in 14 dimensions with optional Solana, XRPL, Bitcoin, and Tron wallets (Stellar and Sui wallets switch on rows inside the base dimensions). Every check is a presence check; the account dimension's two rows per chain (contract code, EIP-7702 delegation, on Ethereum, Base, Arbitrum, Optimism and Polygon) are present or not present. Dimensions arrive in a fixed order: the base dimensions as listed, then any of solana, xrpl, bitcoin and tron that were switched on. The signed |
| Batch trust profiles for up to 10 wallets. Each wallet object supports optional |
| Create signed discount code (INSR-XXXXX, 30-min expiry) for a wallet at a merchant. A code that carries a discount costs 1 credit from the API key that owns the store; a 0% result is free. A caller using another key is not charged. Optional |
Discovery (free)
Tool | Description |
| Browse the merchant directory. Filter by token, verification status. |
| Get full public merchant profile. |
| List the tokens and NFTs listed in the Insumer registry. Filter by chain, symbol, type. A directory, not the list of what can be checked: an attestation checks any token on a supported chain, and NFTs on EVM chains, Solana and XRPL. |
| Calculate discount for a wallet at a merchant. |
Credits & Keys
Tool | Description |
| Buy a new API key with USDC (no auth required). Agent-friendly: no email needed, the sending wallet becomes the key's identity and signs a fixed text naming the payment ( |
| Check credit balance and tier. |
| Buy verification credits with USDC. |
| Confirm USDC payment for a discount code. |
Merchant Onboarding (owner-only)
Tool | Description |
| Create new merchant, owned by the key that creates it. No balance of its own: that key pays for its codes, scans and taps. |
| Get full private merchant details. |
| Set token discount tiers. Tier discounts are whole numbers from 1 to 50. Tokens can carry a display |
| Set NFT collections: a whole-number discount from 1 to 50, or |
| Set discount mode, cap, the terms for wallets without proof of control, USDC payments. |
| Publish merchant to public directory. |
| Kept for compatibility. A store has no balance of its own: a USDC payment submitted here adds regular credits to the API key that owns the store, at a flat 25 credits per $1 ( |
Domain Verification (owner-only)
Tool | Description |
| Request a verification token for a merchant's domain. Returns token and 3 methods (DNS TXT, meta tag, file upload). |
| Complete domain verification after placing the token. Verified merchants get a trust badge. |
Commerce Protocol Integration
Tool | Description |
| Check discount eligibility in OpenAI/Stripe ACP format. Returns coupon objects and per-item allocations. A code that carries a discount costs the store's owner key 1 credit; a 0% result is free. A caller using another key is not charged. |
| Check discount eligibility in Google UCP format. Returns title, extension field, and applied array. A code that carries a discount costs the store's owner key 1 credit; a 0% result is free. A caller using another key is not charged. |
| Validate an INSR-XXXXX discount code. Returns validity, discount percent, expiry. Free, no auth. |
Pricing
Tiers: Free (10 free verifications plus 100 requests a day) | Pro $29/mo (1,000 credits/mo, 10,000/day) | Enterprise $99/mo (5,000 credits/mo, 100,000/day)
Volume discounts: $5–$99 = $0.04/call (25 credits/$1) · $100–$499 = $0.03 (33/$1, 25% off) · $500+ = $0.02 (50/$1, 50% off)
Key and credit purchases are paid in USDC only. Receiving addresses:
USDC on Ethereum, Base, Polygon, Arbitrum, Optimism or Avalanche:
0xee432065474D2C852700f74e3fD81e2Bcc16a3D4USDC on BNB Chain:
0xAd982CB19aCCa2923Df8F687C0614a7700255a23(USDC sent to it on the other EVM chains is also accepted during the changeover)USDC on Solana:
8fyEGM5tRjMocKQWaVXyM2XvvnTxR3sWdrYtug2zeLX4(USDC sent to6a1mLjefhvSJX1sEX8PTnionbE9DqoYjU6F6bNkT4Ydris also accepted during the changeover)
Supported payment chains: Ethereum, Base, Polygon, Arbitrum, Optimism, BNB Chain, Avalanche, Solana. USDT and other tokens are refused and not credited; tokens sent on unsupported chains cannot be recovered. All purchases are final and non-refundable. Full pricing →
Sender signature. A purchase that binds a key to a wallet (every key purchase, a credit purchase on a key with no registered wallet, or updateWallet: true from a different wallet) takes senderSignature: the wallet that sent the payment signs this exact text, five lines joined by \n with no trailing newline:
api.insumermodel.com
Confirm the wallet that sent this payment.
Purpose: key purchase
Chain: eip155:8453
Transaction: 0x<transaction hash, lowercase hex>Purpose is credit purchase for a credit purchase; Chain is eip155:<chainId> on an EVM chain or solana (with the Solana signature as given). Call once without senderSignature and the 400 returns the exact text. EVM wallets sign with personal_sign (EIP-191, 0x hex; smart wallets are checked with ERC-1271); Solana wallets sign with signMessage (ed25519, base58 or base64). A 403 means the signature is not from the wallet that sent the payment; a 503 means a smart-wallet check could not complete and the payment was not used.
Handling rpc_failure Errors
If the API cannot reach one or more blockchain data sources after retries, insumer_attest, insumer_wallet_trust, insumer_verify, insumer_acp_discount, insumer_ucp_discount and insumer_check_discount return ok: false with error code rpc_failure. No signature, no JWT, no credits charged. insumer_batch_wallet_trust answers normally and carries an error entry for any wallet whose reads did not complete, beside the wallets that were signed. This is a retryable error: the MCP client should retry after a short delay (2-5 seconds).
Important: rpc_failure is NOT a verification failure. Do not treat it as pass: false. It means the data source was temporarily unavailable and the API refused to sign an unverified result.
Supported Chains (37)
31 EVM chains + Solana + XRP Ledger + Bitcoin + Tron + Stellar + Sui. Includes Ethereum, Base, Polygon, Arbitrum, Optimism, BNB Chain, Avalanche, XDC, Robinhood Chain, Arc, and 21 more EVM. Full list →
Also Available As
Claude Code Skill:
git clone https://github.com/insumerapi/insumer-skill.git ~/.claude/skills/insumer(GitHub · Smithery), for writing wallet auth into your own projects from inside Claude Code. This MCP server gives an agent runtime access to the API; insumer-skill helps developers author integration code at build time. Different surfaces, same primitive.ElizaOS Plugin:
@insumermodel/plugin-eliza(npm)LangChain (Python):
pip install langchain-insumer(PyPI)OpenAI GPT: InsumerAPI Wallet Auth (GPT Store)
Verifier (offline JWKS):
npm install insumer-verify(npm, source)
Development
npm install
npm run build
# Test with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.jsLicense
MIT
Available Tools
27 toolsinsumer_acp_discountDiscount in ACP formatAInspect
Check token-holder discount eligibility in OpenAI/Stripe Agentic Commerce Protocol (ACP) format. Returns coupon objects, applied/rejected arrays, and per-item allocations compatible with ACP checkout flows. The on-chain check is the same one behind INSR discount codes, wrapped in ACP format. A code that carries a discount costs one credit from the API key that owns the store; a 0% result is free. A caller using another key is not charged, and stores on a licensed platform are covered by its license. Paid discount codes requested with a key other than the store's owner are subject to an hourly limit (429; the message says when to try again). Takes an EVM, Solana or XRPL wallet. An rpc_failure error (503) means a read did not complete and nothing was signed: retry, and never treat it as a no. Optional walletProof proves you control the EVM wallet: the response then says walletProven true, and the full discount its holdings earn applies, without the store's daily limit for unproven wallets. Without it the store's terms for unproven wallets apply, and discountIfProven shows what a proof would get.
Inputs: merchantId (required), items, wallet, xrplWallet, +2 more. Returns: ok, data, keys, meta, +3 more
insumer_attestVerify wallet conditions (signed)AInspect
Evaluate a list of 1 to 10 conditions against a wallet's on-chain state and return one signed attestation: a yes or no for each condition, never the balance. One call reads the chain for every condition in the list and returns a single attestation covering all of them, so conditions of different kinds and on different chains are combined in one signed result. A condition states what must be true of the wallet, such as a minimum token balance, ownership of an NFT, an attestation held or a registered agent ID; the type field on each condition lists the kinds available and the fields each one takes. Chains: EVM chains plus Solana, XRPL, Bitcoin, Tron, Stellar and Sui; Bitcoin, Tron, Stellar and Sui support token_balance only. The attestation is signed twice: ES256, with a kid identifying the key, and a post-quantum ML-DSA-65 signature (pqSig, pqKid). Each result includes evaluatedCondition, a SHA-256 conditionHash, and the block (EVM), ledger (XRPL, Stellar) or checkpoint (Sui) it was read at. An attestation expires 30 minutes after it is signed, or 5 minutes when it includes a delegation condition. Costs 1 credit (2 with proof: 'merkle'). An rpc_failure error (503) means a read did not complete and nothing was signed: retry, and never treat it as a no. Current chain and check counts: https://insumermodel.com/llms.txt
Inputs: conditions (required), proof, format, wallet, +7 more. Returns: ok, data, keys, meta, +3 more
insumer_batch_wallet_trustBatch wallet trust profiles (signed)AInspect
Generate wallet trust fact profiles for up to 10 wallets in a single request. Faster than sequential calls. Each wallet gets an independently signed profile with its own TRST-XXXXX ID: 155 base checks across 27 chains in 10 dimensions (stablecoins, governance, nfts, staking, institutional_stablecoins, tokenized_treasuries, stablecoin_deposits, wrapped_bitcoin, names, account), up to 176 checks across 29 chains in 14 dimensions with the optional Solana, XRPL, Bitcoin and Tron wallets; the signed conditionSetVersion (currently 2026-10-08) names the check list. Dimensions arrive in a fixed order, identical for every wallet in the batch: the base dimensions as listed, then any of solana, xrpl, bitcoin and tron that were switched on, in that order. Supports partial success: failed wallets get error entries while successful ones return full profiles. Costs 3 credits per successful wallet (6 with proof: 'merkle'); credits are charged only for successful profiles, while a pay-per-call (x402) payment covers every wallet in the request. A wallet whose reads did not complete gets an error entry and no signed profile: retry that wallet, and never treat the entry as a no. Each profile lists every check, so the response is large; by default the text is a summary per wallet (profile ID, held / not held / not evaluated counts, and the checks held in each dimension, in the fixed dimension order; the account dimension's checks are present rather than held), and the complete signed profiles are returned unchanged as structuredContent. Set detail to 'full' on the call to get the complete signed profiles as text too. Profiles cannot be fetched again, so a later call signs fresh profiles and is charged again.
Inputs: wallets (required), proof, detail. Returns: ok, data, keys, meta, +3 more
insumer_buy_creditsAdd credits from a paymentADestructiveInspect
Add verification credits to the current API key against a USDC payment the caller has already sent. This tool does not move funds: it submits the transaction hash. Paid in USDC only, on Ethereum, Optimism, BNB Chain, Polygon, Base, Arbitrum, Avalanche or Solana. Receiving addresses: 0xee432065474D2C852700f74e3fD81e2Bcc16a3D4 on Ethereum, Optimism, Polygon, Base, Arbitrum or Avalanche; 0xAd982CB19aCCa2923Df8F687C0614a7700255a23 on BNB Chain (USDC sent to it on the other EVM chains is also accepted during the changeover); 8fyEGM5tRjMocKQWaVXyM2XvvnTxR3sWdrYtug2zeLX4 on Solana (USDC sent to 6a1mLjefhvSJX1sEX8PTnionbE9DqoYjU6F6bNkT4Ydr is also accepted during the changeover). USDT, any other token and any other chain are refused and not credited. Non-refundable. The first purchase registers the sending wallet to the API key; later purchases must come from the same wallet, and updateWallet: true replaces the registered wallet. Registering or replacing the wallet takes senderSignature from the wallet that sent the payment; a payment from the registered wallet needs none. Current prices and volume discounts: https://insumermodel.com/pricing/
Inputs: amount (required), txHash (required), chainId (required), updateWallet, +1 more. Returns: ok, data, keys, meta, +3 more
insumer_buy_keyRegister a paid API keyAInspect
Register a new API key against a USDC payment the caller has already sent (no auth required, no email). This tool does not move funds: it submits the transaction hash and a signature from the wallet that sent the payment. Paid in USDC only, on Ethereum, Optimism, BNB Chain, Polygon, Base, Arbitrum, Avalanche or Solana. Receiving addresses: 0xee432065474D2C852700f74e3fD81e2Bcc16a3D4 on Ethereum, Optimism, Polygon, Base, Arbitrum or Avalanche; 0xAd982CB19aCCa2923Df8F687C0614a7700255a23 on BNB Chain (USDC sent to it on the other EVM chains is also accepted during the changeover); 8fyEGM5tRjMocKQWaVXyM2XvvnTxR3sWdrYtug2zeLX4 on Solana (USDC sent to 6a1mLjefhvSJX1sEX8PTnionbE9DqoYjU6F6bNkT4Ydr is also accepted during the changeover). USDT, any other token and any other chain are refused and not credited. The sending wallet becomes the key's wallet: one key per wallet, and an existing key is topped up with a credit purchase instead. Non-refundable. Current prices and volume discounts: https://insumermodel.com/pricing/
Inputs: amount (required), txHash (required), appName (required), chainId (required), +1 more. Returns: ok, data, keys, meta, +3 more
insumer_buy_merchant_creditsAdd credits to the store owner key from a paymentADestructiveInspect
Kept for compatibility: a store has no credit balance of its own, so a payment submitted here adds regular credits to the API key that owns the store, at a flat rate (the regular credit purchase, with volume tiers, is the usual way to top up). Submits a USDC payment the caller has already sent. This tool does not move funds: it submits the transaction hash. Paid in USDC only, on Ethereum, Optimism, BNB Chain, Polygon, Base, Arbitrum, Avalanche or Solana. Receiving addresses: 0xee432065474D2C852700f74e3fD81e2Bcc16a3D4 on Ethereum, Optimism, Polygon, Base, Arbitrum or Avalanche; 0xAd982CB19aCCa2923Df8F687C0614a7700255a23 on BNB Chain (USDC sent to it on the other EVM chains is also accepted during the changeover); 8fyEGM5tRjMocKQWaVXyM2XvvnTxR3sWdrYtug2zeLX4 on Solana (USDC sent to 6a1mLjefhvSJX1sEX8PTnionbE9DqoYjU6F6bNkT4Ydr is also accepted during the changeover). USDT, any other token and any other chain are refused and not credited. Non-refundable. Owner only. The first purchase registers the sending wallet to the API key; updateWallet: true replaces it. Registering or replacing the wallet takes senderSignature from the wallet that sent the payment; a payment from the registered wallet needs none. Current prices and volume discounts: https://insumermodel.com/pricing/
Inputs: id (required), amount (required), txHash (required), chainId (required), +2 more. Returns: ok, data, keys, meta, +3 more
insumer_check_discountCheck a discount (free)ARead-onlyIdempotentInspect
Calculate discount for a wallet at a merchant. Checks on-chain balances and returns tier and discount percentage per token, never raw balance amounts. Free: does not consume credits. Takes an EVM, Solana or XRPL wallet. An rpc_failure error (503) means a read did not complete: retry, and never treat it as not eligible. The check carries no proof of wallet control, so totalDiscount is what an unproven wallet gets; walletTerms gives the store's terms, and discountIfProven (when present) is what signing would get.
Inputs: merchant (required), wallet, xrplWallet, solanaWallet. Returns: ok, data, keys, meta, +3 more
insumer_compliance_templatesList compliance templatesARead-onlyIdempotentInspect
List the compliance templates available for EAS attestation conditions. Each template carries pre-configured schema IDs, attester addresses, and decoder contracts for a KYC or identity provider (Coinbase Verifications on Base, Gitcoin Passport on Optimism), so a condition can name the template instead of raw EAS parameters. No authentication or credits required.
Inputs: no named parameters. Returns: ok, data, keys, meta, +3 more
insumer_configure_nftsConfigure merchant NFTs (replaces)ADestructiveIdempotentInspect
Configure the NFT collections a merchant recognizes, each granting a discount or recognition only. Replaces the existing NFT configuration. Max 4 collections. Discounts are whole numbers from 1 to 50; a value with decimals is refused. Owner only.
Inputs: id (required), nftCollections (required). Returns: ok, data, keys, meta, +3 more
insumer_configure_settingsUpdate merchant settingsADestructiveIdempotentInspect
Update merchant settings: discount stacking mode, cap, the store's terms for wallets sent without proof of control, and stablecoin payment configuration. All fields optional; supplied fields replace their current values. discountCap is a whole number from 1 to 100. A wallet with proof gets the full discount their holdings earn, without the daily limit for unproven buyers. Owner only.
Inputs: id (required), discountCap, usdcPayment, discountMode, +2 more. Returns: ok, data, keys, meta, +3 more
insumer_configure_tokensConfigure merchant tokens (replaces)ADestructiveIdempotentInspect
Configure merchant token discount tiers. Set own token and/or partner tokens. Replaces the existing token configuration. Max 8 tokens total. Tier discounts are whole numbers from 1 to 50; a value with decimals is refused. Owner only.
Inputs: id (required), ownToken, partnerTokens. Returns: ok, data, keys, meta, +3 more
insumer_confirm_paymentConfirm a discount paymentBIdempotentInspect
Confirm the USDC payment for an INSR discount code. The server verifies the on-chain transaction receipt.
Inputs: code (required), amount (required), txHash (required), chainId (required). Returns: ok, data, keys, meta, +3 more
insumer_create_merchantCreate a merchantAInspect
Create a new merchant, owned by the API key that creates it. The store has no credit balance of its own: that key pays for the store's codes, scans and taps, and credits in the response is that key's balance. Limited number of merchants per API key.
Inputs: companyId (required), companyName (required), location. Returns: ok, data, keys, meta, +3 more
insumer_creditsCheck credit balanceARead-onlyIdempotentInspect
Check verification credit balance, tier, and daily rate limit for the current API key.
Inputs: no named parameters. Returns: ok, data, keys, meta, +3 more
insumer_get_merchantGet a merchant profileARead-onlyIdempotentInspect
Get full public merchant profile including token tiers, NFT collections, discount mode, verification status, and walletTerms: what the store gives a wallet with and without proof of control, so you can decide whether to sign before creating a code.
Inputs: id (required). Returns: ok, data, keys, meta, +3 more
insumer_jwksGet public signing keysARead-onlyIdempotentInspect
Get InsumerAPI's public signing keys as a JWKS (JSON Web Key Set): an ECDSA P-256 key under its kids, followed by the ML-DSA-65 post-quantum key as RFC 9964 AKP entries. Signatures on attestation and trust responses verify against these keys. Match an entry by the kid (or pqKid) on the response, never by position; an unknown kid is unverifiable, not refuted. No authentication required.
Inputs: no named parameters. Returns: ok, data, keys, meta, +3 more
insumer_list_merchantsList merchantsARead-onlyIdempotentInspect
Browse merchants in the public directory. Filter by accepted token, verification status. Returns company name, website, tokens accepted, discount info, and walletTerms (the store's terms with and without proof of wallet control).
Inputs: limit, token, offset, verified. Returns: ok, data, keys, meta, +3 more
insumer_list_tokensList registered tokensARead-onlyIdempotentInspect
List the tokens and NFT collections listed in the Insumer registry. Filter by chain, symbol, or asset type. The registry is a directory, not the list of what can be checked: an attestation can check any token on a supported chain, and NFTs on EVM chains, Solana and XRPL, whether listed or not. An empty result means nothing is listed under that filter, not that the token is unsupported.
Inputs: type, chain, symbol. Returns: ok, data, keys, meta, +3 more
insumer_merchant_statusGet merchant status (owner)ARead-onlyIdempotentInspect
Get full private merchant details: credits (the owner key's balance), token configs, NFT collections, directory status, verification status, payment settings. Owner only.
Inputs: id (required). Returns: ok, data, keys, meta, +3 more
insumer_publish_directoryPublish directory listingAIdempotentInspect
Publish or refresh the merchant's listing in the public directory from its current tokens and settings. Owner only.
Inputs: id (required). Returns: ok, data, keys, meta, +3 more
insumer_request_domain_verificationRequest domain verificationAInspect
Request a domain verification token for a merchant. Returns the token and three ways to place it: DNS TXT record, HTML meta tag, or file upload. Verified merchants get a trust badge in the public directory. Owner only.
Inputs: id (required), domain (required). Returns: ok, data, keys, meta, +3 more
insumer_setupCreate a free API keyAInspect
Generate a free-tier InsumerAPI key (insr_live_...). No credit card required. The user adds the key to their MCP config as INSUMER_API_KEY and restarts. One free key per email, with a per-IP daily limit. Free-tier allowance: https://insumermodel.com/pricing/
Inputs: email (required), appName. Returns: ok, data, keys, meta, +3 more
insumer_ucp_discountDiscount in UCP formatAInspect
Check token-holder discount eligibility in Google Universal Commerce Protocol (UCP) format. Returns title, extension field, and applied array compatible with UCP checkout flows. The on-chain check is the same one behind INSR discount codes, wrapped in UCP format. A code that carries a discount costs one credit from the API key that owns the store; a 0% result is free. A caller using another key is not charged, and stores on a licensed platform are covered by its license. Paid discount codes requested with a key other than the store's owner are subject to an hourly limit (429; the message says when to try again). Takes an EVM, Solana or XRPL wallet. An rpc_failure error (503) means a read did not complete and nothing was signed: retry, and never treat it as a no. Optional walletProof proves you control the EVM wallet: the response then says walletProven true, and the full discount its holdings earn applies, without the store's daily limit for unproven wallets. Without it the store's terms for unproven wallets apply, and discountIfProven shows what a proof would get.
Inputs: merchantId (required), items, wallet, xrplWallet, +2 more. Returns: ok, data, keys, meta, +3 more
insumer_validate_codeValidate a discount codeARead-onlyIdempotentInspect
Validate an INSR-XXXXX discount code. For merchant backends during ACP/UCP checkout to confirm code validity, discount percent, and expiry. Returns valid/invalid status with reason, and walletProven (whether the code went to a caller that proved control of the wallet). No authentication required, no credits consumed. Does not expose wallet or token data.
Inputs: code (required). Returns: ok, data, keys, meta, +3 more
insumer_verifyCreate a discount codeAInspect
Create a signed discount code (INSR-XXXXX, 30-minute expiry) for a wallet at a merchant. Returns tier and discount percentage, never raw balance amounts. A code that carries a discount costs one credit from the API key that owns the store; a 0% result is free. A caller using another key is not charged, and stores on a licensed platform are covered by its license. Paid discount codes requested with a key other than the store's owner are subject to an hourly limit (429; the message says when to try again). If the merchant has Stripe Connect, a coupon is auto-created. Takes an EVM, Solana or XRPL wallet. An rpc_failure error (503) means a read did not complete and no code was issued: retry, and never treat it as a no. Optional walletProof proves you control the EVM wallet: the response then says walletProven true, and the full discount its holdings earn applies, without the store's daily limit for unproven wallets. Without it the store's terms for unproven wallets apply, and discountIfProven shows what a proof would get.
Inputs: merchantId (required), wallet, xrplWallet, walletProof, +1 more. Returns: ok, data, keys, meta, +3 more
insumer_verify_domainVerify domain ownershipAIdempotentInspect
Check a merchant's previously requested domain verification token. The server looks for it as a DNS TXT record, HTML meta tag, or uploaded file, and marks the domain verified when found. Rate limited per merchant (429 says when to retry). Owner only.
Inputs: id (required). Returns: ok, data, keys, meta, +3 more
insumer_wallet_trustWallet trust profile (signed)AInspect
Generate a signed wallet trust fact profile for an EVM wallet: a curated set of presence checks organized into dimensions (stablecoins, governance, nfts, staking, institutional_stablecoins, tokenized_treasuries, stablecoin_deposits, wrapped_bitcoin, names, account): 155 base checks across 27 chains in 10 dimensions. Optional Solana, XRPL, Bitcoin and Tron wallets add their own dimensions, up to 176 checks across 29 chains in 14 dimensions; optional Stellar and Sui wallets let rows inside existing dimensions evaluate. Dimensions arrive in a fixed order: the base dimensions as listed, then any of solana, xrpl, bitcoin and tron that were switched on, in that order. The account dimension holds two rows per chain on Ethereum, Base, Arbitrum, Optimism and Polygon: contract code at the wallet address, and an EIP-7702 delegation there; a plain key reads false on both, and which contract is never named. Rows on a chain whose wallet is not supplied stay in the signed profile with evaluated: false. Every check is held or not held (present or not present in the account dimension), never a balance. The signed conditionSetVersion (currently 2026-10-08) names the check list that was run; log it, never reject on it. Returns per-dimension pass/fail counts and an overall summary: no score, no opinion. Designed for AI agent-to-agent trust decisions. Costs 3 credits (6 with proof: 'merkle'). An rpc_failure error (503) means a read did not complete and nothing was signed: retry, and never treat it as a no. Current chain and check counts: https://insumermodel.com/llms.txt
Inputs: wallet (required), proof, suiWallet, tronWallet, +4 more. Returns: ok, data, keys, meta, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
The three credential-purchase tools (buy_credits, buy_key, buy_merchant_credits) and the cluster of discount tools (verify, check_discount, acp_discount, ucp_discount, validate_code) perform near-identical on-chain work in different wrappers, and buy_merchant_credits is explicitly a legacy compatibility shim. Long descriptions do help distinguish them, and the attest vs. wallet_trust split is clear, but an agent must read carefully to avoid misselection.
All 27 tools share the insumer_ prefix and snake_case, with consistent verb_noun forms like list_merchants, configure_tokens, buy_credits. A few deviations (insumer_attest, insumer_verify as bare verbs; insumer_jwks and insumer_credits as nouns) are readable but break the pattern.
27 tools is heavy for the surface, and several earn their place only marginally: the deprecated buy_merchant_credits, the near-duplicate acp_discount/ucp_discount wrappers, and three separate purchase entry points. The genuine domain breadth (attestations, merchant admin, billing, registry, protocol adapters) justifies most of the count.
Coverage is broad: condition attestation, trust profiles, discount lifecycle, merchant creation/config/publishing/domain verification, key and credit billing, and JWKS verification. Minor gaps remain, such as no merchant update/delete or way to enumerate the caller's own merchants, but no core workflow dead-ends.
Maintenance
Related MCP Connectors
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Compliance MCP for AI agents: sanctions & KYT screening on 50+ chains, stablecoin-freeze, oracle.
Crypto market intelligence, token rug-checks, and wallet verification in one MCP server.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that empowers AI agents to inspect any wallet’s balance and onchain activity across major EVM chains and Solana chain.39MIT
- AlicenseCqualityBmaintenanceMolTrust MCP Server provides AI agents with identity verification, reputation scoring, and verifiable credentials through W3C DID-based trust infrastructure. Includes ERC-8004 on-chain agent registration and Base blockchain anchoring for tamper-proof credential verification.48158 PyPI5MIT
- AlicenseAqualityDmaintenanceMCP server for AI agent trust verification, enabling agents to verify identities, check trust scores, and build reputation across multiple blockchain and web platforms.1220 npm1MIT

Syeniteofficial
FlicenseNot gradedqualityCmaintenanceA DeFi MCP server enabling AI agents to query lending rates, execute swaps/bridges, monitor positions, and access prediction markets across 30+ chains with a trust layer for calldata verification.-