Skip to content
MCP server

Insumer

Check wallet balances and NFT ownership across chains and get a signed yes or no

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
1.24.0
Listing updated
3 days ago

About Insumer

Insumer is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

Every answer comes back as a boolean signed with ECDSA, so an agent or your own backend can verify the result client-side instead of trusting a raw balance. The docs cover token balances on 37 blockchains, NFT ownership on 33 and EAS attestations on 5, and say the service reads public chain state, so it works the same from any country.

The MCP server is published on npm as mcp-server-insumer (version 1.24.0) and also runs remotely over streamable HTTP. You can start it without a key and ask your agent to call insumer_setup with an email address to create a free key. As an alternative, set a throwaway Base wallet key and each metered call is paid in USDC through x402, with a cap per call that defaults to 3 USDC.

It suits token-gated access, airdrop eligibility checks and agent workflows that need proof of holdings rather than a screenshot.

Install

Run in a terminal

claude mcp add --transport http insumer https://api.insumermodel.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.insumermodel.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "insumer": {
      "url": "https://api.insumermodel.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "insumer": {
      "type": "http",
      "url": "https://api.insumermodel.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "insumer": {
      "serverUrl": "https://api.insumermodel.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "insumer": {
      "type": "http",
      "url": "https://api.insumermodel.com/mcp"
    }
  }
}

Configuration

  • INSUMER_API_KEYInsumerAPI key (starts with insr_live_). Either this or INSUMER_PAYMENT_KEY.
  • INSUMER_PAYMENT_KEYPrivate 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).

Tools this server provides (10)

Read directly from the server.

insumer_attest
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 o
insumer_compliance_templates
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.
insumer_wallet_trust
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 17
insumer_batch_wallet_trust
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 acr
insumer_jwks
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.
insumer_list_merchants
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).
insumer_get_merchant
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.
insumer_list_tokens
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.
insumer_check_discount
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 unpro
insumer_validate_code
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.

What it does

Signed boolean results
Each attestation carries a signature that can be verified on the client.
Wide chain coverage
Token balances on 37 chains, NFT ownership on 33 and EAS attestations on 5.
Wallet trust checks
Separate tools score a single wallet or a batch of wallets.
Agent-created keys
The insumer_setup tool issues a free key from an email address.
Pay-per-call option
x402 payments in USDC on Base replace an API key, with a per-call spending cap.
Remote or local
Run the npm package over stdio or connect to the hosted streamable-http endpoint.

Good for

  • Gate content or a Discord role on holding a token or NFT
  • Verify an agent or user wallet before releasing funds or access
  • Check airdrop or allowlist eligibility across several chains
  • Add a signed proof of holdings to an automated workflow

Pricing

Freemium

Free key with 10 verification credits and 100 requests a day; paid tiers and x402 pay-per-call in USDC

Prices change. Check insumermodel.com before you buy.

Insumer FAQ

How do I get an API key?

Call the insumer_setup tool with your email, use the curl command in the README, or enter your email on the InsumerAPI site. A free key includes 10 verification credits and 100 requests a day.

Can I use it without an account?

Yes. Set INSUMER_PAYMENT_KEY to a throwaway Base wallet holding a little USDC and metered calls are paid per call through x402.

Which tools are metered?

The README names insumer_attest, insumer_wallet_trust and insumer_batch_wallet_trust as metered; insumer_setup creates the key.

Is there a spending limit in pay-per-call mode?

INSUMER_MAX_PAYMENT_USDC caps what the server pays for one call, with a default of 3.

Is Insumer free?

Insumer has a free plan, with paid plans for more usage or features.

How do I add Insumer to Claude Code?

Run this command in your terminal: claude mcp add --transport http insumer https://api.insumermodel.com/mcp

What are the best alternatives to Insumer?

The closest alternatives to Insumer are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Insumer

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools