LABSCO SUMMARY

The answer is a signed boolean, so whatever you hand downstream carries its own proof.

An attestation travels with the exact condition it evaluated, a SHA-256 hash of that logic, the block it read and an ECDSA P-256 signature, which lets a merchant backend or an API gateway check it without trusting whoever passed it along — and requesting the JWT form puts it in a shape ordinary middleware already accepts. Two behaviours to build around: token_balance thresholds must be decimal strings, because keys issued from 2026-06-10 sign as insumer-attest-v2 and reject a JSON number with a 400; and when a data source is unreachable the call comes back as rpc_failure with no signature and no credit charged, so retry after a few seconds rather than reading it as a failed check.

What it is

An MCP server for InsumerAPI, which answers questions about a wallet without disclosing what is in it. You pass an address and 1 to 10 conditions — token balances, NFT ownership, EAS attestations, Farcaster identity, ERC-8004 agent registration, ERC-7710 delegation validity, or an arbitrary boolean view call — and get back a signed pass or fail evaluated across 32 EVM chains plus Solana, XRP Ledger, Bitcoin, Tron, Stellar and Sui. The rest of the catalogue is the commerce layer built on that primitive: token-holder discounts, merchant records, and the credits that pay for both.

What you get

insumer_attest evaluates the conditions and returns an ECDSA-signed boolean carrying the evaluatedCondition, a SHA-256 conditionHash of the exact logic, and the block it read — 1 credit, or 2 with proof: "merkle" for EIP-1186 storage proofs
Ask for format: "jwt" and the same attestation arrives as an ES256 JWT that Kong, Nginx, Cloudflare Access or AWS API Gateway can validate against the JWKS at GET /v1/jwks; insumer_jwks fetches that key set with no authentication
insumer_wallet_trust builds a signed profile — 44 checks across 25 chains in 5 dimensions covering stablecoins, governance, NFTs, staking and institutional stablecoins, rising to 49 checks across 27 chains in 9 dimensions once Solana, XRPL, Bitcoin and Tron addresses are supplied. 3 credits, 6 with merkle
insumer_batch_wallet_trust profiles up to 10 wallets in one request with shared block fetches, 5-8x faster than sequential calls, and returns error entries for the ones that fail instead of dropping the batch
On the commerce side insumer_check_discount reports tier and discount percentage for free and never the raw balance, insumer_verify mints a signed INSR-XXXXX code with a 30-minute expiry, and insumer_acp_discount and insumer_ucp_discount wrap the same check in OpenAI/Stripe ACP and Google UCP checkout shapes
insumer_validate_code lets a merchant backend confirm a code's validity, discount percent and expiry with no key, no credits and no exposure of wallet or token data
Merchant onboarding runs from the same session: insumer_create_merchant arrives with 100 free credits and caps at 10 merchants per key, insumer_configure_tokens takes up to 8 tokens, insumer_configure_nfts up to 4 collections, and domain verification accepts a DNS TXT record, an HTML meta tag or a file upload
Discovery costs nothing: insumer_list_merchants, insumer_get_merchant, insumer_list_tokens, and insumer_compliance_templates for the pre-configured EAS schemas (Coinbase Verifications on Base, Gitcoin Passport on Optimism)

Requirements

Runs over stdio as npx -y mcp-server-insumer and reads INSUMER_API_KEY, a key beginning insr_live_. You can obtain one inside the session: insumer_setup takes an email and returns a free key with 10 verification credits and 100 calls a day, limited to one key per email and 3 per IP per day. Instead of a key you can set INSUMER_PAYMENT_KEY to a throwaway Base wallet holding a few dollars of USDC and let metered calls pay inline over x402 — an attestation costs $0.05 and a trust profile $0.15, and the wallet needs no ETH because settlement is gasless. Paid tiers are Pro at $29/mo for 1,000 credits a month and Enterprise at $99/mo for 5,000. MIT.

Setup effort

One command plus a key — npx -y mcp-server-insumer, then supply credentials

See installation options

USE CASES

Gating a feature on what a wallet holds, without seeing the wallet

Evaluate the balance or ownership conditions you care about and act on the signed boolean. The response reports which conditions were met and the block they were read at, never an amount.

insumer_attestinsumer_jwks

Putting wallet auth behind an API gateway you already run

Request the attestation as a JWT and let Kong, Nginx, Cloudflare Access or AWS API Gateway verify it against the published key set — no custom verification code in the path.

insumer_attestinsumer_jwks

Scoring a counterparty wallet before doing business with it

One call returns a signed profile across stablecoins, governance, NFTs, staking and institutional stablecoins; add the Solana, XRPL, Bitcoin and Tron addresses to widen it.

insumer_wallet_trustinsumer_batch_wallet_trust

Checking a KYC or identity attestation a provider already issued

List the compliance templates to get the schema ID, attester address and decoder for Coinbase Verifications or Gitcoin Passport, then name the template in the attestation conditions.

insumer_compliance_templatesinsumer_attest

Giving token holders a discount at checkout

Work out the tier and percentage for free first, then mint the signed code with its 30-minute expiry, and confirm the on-chain payment once it lands.

insumer_check_discountinsumer_verifyinsumer_confirm_payment

Wiring holder discounts into an agentic checkout flow

The same on-chain check returned in ACP or UCP shape — coupon objects and per-item allocations for one, title and applied array for the other — and a free call for the backend to validate the code it receives.

insumer_acp_discountinsumer_ucp_discountinsumer_validate_code

Standing up a merchant and listing it publicly

Create the merchant, set the token tiers and NFT collections that earn a discount, choose stacking mode and cap, verify the domain for the trust badge, then publish to the directory.

insumer_create_merchantinsumer_configure_tokensinsumer_request_domain_verificationinsumer_publish_directory

27 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`insumer_acp_discount`

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. Same on-chain verification as insumer_verify, wrapped in ACP format. Consumes 1 merchant credit.

`insumer_attest`

Create on-chain verification (attestation). Verify 1-10 conditions (token balances, NFT ownership, EAS attestations, Farcaster identity, arbitrary boolean view calls, supply/amount ratios, ERC-8004 agent registration, ERC-7710 delegation validity) across 38 chains (32 EVM + Solana + XRPL + Bitcoin + Tron + Stellar + Sui). nft_ownership is supported on 34 of the 38 (32 EVM + Solana + XRPL); Bitcoin, Tron, Stellar and Sui are token_balance only. Returns ECDSA-signed boolean results with a kid field identifying the signing key (fetch public key via insumer_jwks). Never exposes actual balances. Each result includes evaluatedCondition (exact logic checked), conditionHash (SHA-256 for tamper-evidence), and blockNumber/blockTimestamp for RPC chains (freshness). XRPL results include ledgerIndex and ledgerHash instead of blockNumber/blockTimestamp; trust line results also include trustLineState: { frozen: boolean }. Stellar results include ledgerIndex and ledgerHash and surface assetCode (which flows into conditionHash for non-native asset binding). Sui results include checkpointSequence and checkpointDigest. Standard mode costs 1 credit. Pass proof: 'merkle' for EIP-1186 Merkle storage proofs (2 credits). For EAS attestations, use a compliance template (Coinbase Verifications, Gitcoin Passport) or raw schemaId. For Farcaster, use type 'farcaster_id' (checks IdRegistry on Optimism). For arbitrary contract checks, use type 'evm_view_call' (single-address-argument view function returning bool; RPC EVM chains only). For self-scaling agent-spend limits, use type 'ratio_to_amount' (met iff balance >= multiple * amount; RPC EVM chains only). For share-of-supply rules, use type 'ratio_to_supply' (met iff balance / totalSupply >= minFraction, a fraction in (0,1]; RPC EVM chains, ERC-20 only). For agent standing, use type 'erc8004_agent' (is this wallet a registered ERC-8004 agent on Base; agentId required) or 'erc7710_delegation' (is this signed MetaMask-framework delegation from principal to agent currently valid on Base: signature incl. ERC-1271, unrevoked at the anchored block, recognized caveats, time window; spend/target/call limits are REPORTED as declaredLimits, not simulated). Attestations containing a delegation condition expire in 5 minutes instead of 30. On failure a delegation result carries failReason (delegate_mismatch, principal_mismatch, invalid_signature, delegator_not_deployed, revoked, unknown_caveat_enforcer, outside_time_window). Use insumer_compliance_templates to list available templates.

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y mcp-server-insumer

MCP Clients

Claude Desktop, Cursor, Windsurf

JSON

{
  "mcpServers": {
    "insumer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-insumer"
      ],
      "env": {
        "INSUMER_API_KEY": "<YOUR_INSUMER_API_KEY>"
      }
    }
  }
}

Any MCP client — pay per call

ANY MCP CLIENT — PAY PER CALL · JSON

{
  "mcpServers": {
    "insumer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-insumer"
      ],
      "env": {
        "INSUMER_PAYMENT_KEY": "0x<YOUR_THROWAWAY_WALLET_PRIVATE_KEY>"
      }
    }
  }
}

MCP Server Insumer

The answer is a signed boolean, so whatever you hand downstream carries its own proof.

What it is

What you get

Requirements

Setup effort

Gating a feature on what a wallet holds, without seeing the wallet

Putting wallet auth behind an API gateway you already run

Scoring a counterparty wallet before doing business with it

Checking a KYC or identity attestation a provider already issued

Giving token holders a discount at checkout

Wiring holder discounts into an agentic checkout flow

Standing up a merchant and listing it publicly

27 tools

insumer_acp_discount

insumer_attest

insumer_batch_wallet_trust

insumer_buy_credits

insumer_buy_key

insumer_buy_merchant_credits

insumer_check_discount

insumer_compliance_templates

insumer_configure_nfts

insumer_configure_settings

insumer_configure_tokens

insumer_confirm_payment

insumer_create_merchant

insumer_credits

insumer_get_merchant

insumer_jwks

insumer_list_merchants

insumer_list_tokens

insumer_merchant_status

insumer_publish_directory

insumer_request_domain_verification

insumer_setup

insumer_ucp_discount

insumer_validate_code

insumer_verify

insumer_verify_domain

insumer_wallet_trust

What to know first

Tools you get

Requires

Where it runs

Moderate Standing cost

Connect your client

Server setup

MCP Clients

Claude Desktop, Cursor, Windsurf

Any MCP client — pay per call

Same category

SVM-MCP

RugCheck AI

DRPC Agent Skills

OneSource MCP

`insumer_acp_discount`

`insumer_attest`

`insumer_batch_wallet_trust`

`insumer_buy_credits`

`insumer_buy_key`

`insumer_buy_merchant_credits`

`insumer_check_discount`

`insumer_compliance_templates`

`insumer_configure_nfts`

`insumer_configure_settings`

`insumer_configure_tokens`

`insumer_confirm_payment`

`insumer_create_merchant`

`insumer_credits`

`insumer_get_merchant`

`insumer_jwks`

`insumer_list_merchants`

`insumer_list_tokens`

`insumer_merchant_status`

`insumer_publish_directory`

`insumer_request_domain_verification`

`insumer_setup`

`insumer_ucp_discount`

`insumer_validate_code`

`insumer_verify`

`insumer_verify_domain`

`insumer_wallet_trust`