Insumer logo

Insumer

Verify wallet conditions, create signed trust facts and discounts, and manage token-based merchant eligibility across supported chains.

Install Insumer

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "insumer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-insumer"
      ],
      "env": {
        "INSUMER_API_KEY": "YOUR_VALUE_HERE",
        "INSUMER_PAYMENT_KEY": "YOUR_VALUE_HERE",
        "INSUMER_MAX_PAYMENT_USDC": "YOUR_VALUE_HERE",
        "PORT": "YOUR_VALUE_HERE",
        "INSUMER_HOSTED_TOOLS": "YOUR_VALUE_HERE",
        "INSUMER_DAILY_CAP": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

insumer connects MCP clients to InsumerAPI for read-only blockchain checks, signed attestations, wallet trust profiles, and token-based discounts. Its tools evaluate conditions across EVM networks, Solana, XRPL, Bitcoin, Tron, Stellar, and Sui without returning wallet balances or amounts. Merchants can configure token and NFT discounts, publish directory listings, and produce ACP- or UCP-compatible eligibility results. Use it when an agent needs independently verifiable wallet facts or commerce decisions based on on-chain state.

Use cases

  • Verify wallet conditions before granting access
  • Generate signed wallet trust profiles for agent decisions
  • Check token-holder discounts during checkout
  • Create and publish a merchant discount program
  • Validate discount codes in ACP or UCP flows

Key features

  • Cross-chain signed boolean attestations
  • ECDSA and ML-DSA-65 response signatures
  • Wallet trust profiles and batch processing
  • Token and NFT merchant discount configuration
  • ACP and UCP discount responses
  • Offline verification through published JWKS keys

Tools27

What Insumer lets your agent do. Expand a tool for its parameters.

Verified live~15.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 37d

What it can do

From the 27 tools this server returned when we ran it; 27 declare their own safety hints.

Can delete or modify data · 5Handles credentials · 19Makes network requests · 27Read-only tools · 22
Network at startup3 connections
Files written at startupNone
Install scriptsprepare
npm provenanceNot published
Package age247 days
Maintainers1

Observed 2026-10-29 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · mcp-server-insumer (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads2.1kPackage downloads in the last 30 days.
Last commit14d agoMost recent push to the default branch.
Tools exposed27Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Insumer works

What insumer does

insumer exposes InsumerAPI through MCP for wallet verification, trust profiling, merchant discovery, and token-holder discounts. The central insumer_attest tool evaluates one to ten conditions in a single request and returns signed yes/no results. Conditions can cover token holdings, NFT ownership, EAS-based compliance attestations, or registered agent IDs. Responses include the evaluated condition logic, a SHA-256 condition hash, and the chain position used for the read.

Results do not expose balances or raw amounts. Attestations are signed with ECDSA P-256 and ML-DSA-65, and the matching public keys are available through insumer_jwks. They expire after 30 minutes, or after five minutes when delegation is involved. An RPC failure means no result was signed and must not be interpreted as a failed condition.

How it works

An MCP client sends wallet addresses and tool parameters to the local package or to the hosted streamable-HTTP endpoint. The server reads supported chains, applies the requested conditions, and returns structured MCP data. EVM calls can optionally include Merkle proofs for balance verification against a block header.

insumer_wallet_trust creates a signed fact profile for one EVM wallet, with optional wallets from other networks. The profile reports held, not held, and unevaluated checks across fixed dimensions; it provides counts and summaries rather than a score or opinion. insumer_batch_wallet_trust performs the same operation for up to ten wallets and allows partial success.

Discount tools check eligibility for a merchant and can issue short-lived INSR-XXXXX codes. insumer_acp_discount and insumer_ucp_discount adapt the same on-chain check to OpenAI/Stripe ACP and Google UCP checkout formats. Wallet-control proof can affect the discount terms applied to an EVM wallet.

Setup and configuration

Run the package with npx -y mcp-server-insumer and add it to an MCP client using stdio. Set INSUMER_API_KEY to an insr_live_... key. A free key can be generated with the insumer_setup tool, which requires an email and can be called before configuring a key. The package also supports INSUMER_PAYMENT_KEY for x402 pay-per-call billing from a dedicated Base wallet funded with USDC.

The hosted endpoint is https://api.insumermodel.com/mcp and requires no local installation. It exposes the anonymous subset of tools, including attestations, trust profiles, directories, free discount checks, key retrieval, and code validation. Local deployment can run node build/http.js; PORT, INSUMER_HOSTED_TOOLS, and INSUMER_DAILY_CAP control optional HTTP settings. INSUMER_MAX_PAYMENT_USDC limits x402 spending.

Tools and capabilities

  • Evaluate up to ten cross-chain wallet conditions in one signed attestation.
  • Generate single-wallet or batch wallet trust fact profiles.
  • Retrieve signing keys for offline signature verification.
  • Browse registered tokens, NFT collections, and public merchants.
  • Create and manage merchants, token tiers, NFT recognition, caps, stacking, and payment settings.
  • Issue, check, validate, and confirm INSR-XXXXX discount codes.
  • Return discount eligibility in ACP and UCP formats.
  • Buy API keys or credits with already-submitted USDC transactions.
  • Request and verify merchant domains using DNS, HTML, or file placement.

Limitations and notes

Verification calls consume credits or use x402 payment, depending on configuration. Trust profiles cost more than individual attestations, and batch billing applies per successful profile. Discount codes that carry a discount charge the merchant owner’s key; zero-percent results are free.

The registry tools describe listed assets only. Attestations can evaluate supported-chain assets that are not listed, subject to the condition types available for that chain. Merchant configuration and private status tools require ownership of the merchant. USDC payment tools accept only the listed chains and reject other tokens. Failed chain reads return errors rather than signed negative results, so callers should retry them.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Insumer

insumer is an MCP server that connects AI agents to InsumerAPI for signed blockchain attestations, wallet trust profiles, merchant discount checks, and code validation. It evaluates wallet conditions across supported EVM and non-EVM chains, returns boolean facts instead of balances, and provides keys for offline signature verification.

Install it through an MCP client with `npx -y mcp-server-insumer` and configure the command in that client’s MCP settings. Set `INSUMER_API_KEY` to an InsumerAPI key, or use the setup tool to generate a free key before restarting the client.

Yes, insumer works with Cursor through its MCP settings. Add the server command `npx -y mcp-server-insumer` and provide `INSUMER_API_KEY` in the server environment. The same stdio configuration is also documented for Claude Desktop and Windsurf.

Yes, insumer evaluates balance conditions and returns only whether each condition passed or failed. Attestations include signed condition details and the block or ledger reference used for the read, but they do not return raw wallet balances or amounts.

Use the merchant management tools to create and configure a store, then call `insumer_verify` to issue an `INSR-XXXXX` code for an eligible wallet. Token tiers, NFT collections, stacking, caps, wallet terms, and directory publication are configured with separate owner-only tools.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewInsumer AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/insumer?style=directory)](https://allmcps.com/mcp/insumer)
HTML Embed
<a href="https://allmcps.com/mcp/insumer"><img src="https://allmcps.com/api/badge/insumer?style=directory" alt="Insumer on AllMCPs" /></a>