insumer MCP server

What does insumer need from you?

API key — InsumerAPI key (starts with insr_live_). Either this or INSUMER_PAYMENT_KEY.

• INSUMER_API_KEYoptionalsecretEnvironment variable

  InsumerAPI key (starts with insr_live_). Either this or INSUMER_PAYMENT_KEY.

• INSUMER_PAYMENT_KEYoptionalsecretEnvironment variable

  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_USDCoptionalEnvironment variable

  Most USDC the server will pay for one call in pay-per-call mode (default 3).

Pass secrets through your shell environment rather than committing them into a config file.

What tools does insumer expose? (27)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

• insumer_setupGenerate a free API key instantly. Takes an email, returns an `insr_live_...` key with 10 free verifications plus 100 requests a day. No credit card required.
• insumer_jwksGet the JWKS: five entries over two keys. The ECDSA P-256 key under `insumer-attest-v1`, `insumer-attest-v2`, and `insumer-trust-v2`, followed by the ML-DSA-65 post-quantum key under two RFC 9964 `AKP` entries, `insumer-attest-pq1` and `ins
• insumer_attestVerify on-chain conditions (token balances, NFT ownership, EAS attestations, Farcaster identity, `evm_view_call` for arbitrary boolean view functions, `ratio_to_amount` for self-scaling agent-spend limits and `ratio_to_supply` for share-of-
• insumer_compliance_templatesList available EAS compliance templates (Coinbase Verifications on Base, Gitcoin Passport on Optimism). Free.
• insumer_wallet_trustGenerate 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, accoun
• insumer_batch_wallet_trustBatch trust profiles for up to 10 wallets. Each wallet object supports optional `solanaWallet`, `xrplWallet`, `bitcoinWallet`, `tronWallet`, `stellarWallet`, and `suiWallet`. Faster than sequential calls. Partial success supported. 3 credit
• insumer_verifyCreate 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
• insumer_list_merchantsBrowse the merchant directory. Filter by token, verification status.
• insumer_get_merchantGet full public merchant profile.
• insumer_list_tokensList 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.
• insumer_check_discountCalculate discount for a wallet at a merchant.
• insumer_buy_keyBuy 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 (`senderSignature`; a call without it returns the text). One key per wa
• insumer_creditsCheck credit balance and tier.
• insumer_buy_creditsBuy verification credits with USDC. `amount` required, minimum $5. Volume discounts: $0.04–$0.02/call. Supported chains: Ethereum, Base, Polygon, Arbitrum, Optimism, BNB Chain, Avalanche, Solana. Non-refundable. First purchase registers the
• insumer_confirm_paymentConfirm USDC payment for a discount code.
• insumer_create_merchantCreate new merchant, owned by the key that creates it. No balance of its own: that key pays for its codes, scans and taps.
• insumer_merchant_statusGet full private merchant details.
• insumer_configure_tokensSet token discount tiers. Tier discounts are whole numbers from 1 to 50. Tokens can carry a display `name` and `logo`; the own token takes `enabled`.
• insumer_configure_nftsSet NFT collections: a whole-number discount from 1 to 50, or `benefitType: "recognition"` for recognition only. `enabled: false` keeps a collection switched off.
• insumer_configure_settingsSet discount mode, cap, the terms for wallets without proof of control, USDC payments.
• insumer_publish_directoryPublish merchant to public directory.
• insumer_buy_merchant_creditsKept 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 (`insumer_buy_credits` has the volume tiers). `amount` required, m
• insumer_request_domain_verificationRequest a verification token for a merchant's domain. Returns token and 3 methods (DNS TXT, meta tag, file upload).
• insumer_verify_domainComplete domain verification after placing the token. Verified merchants get a trust badge.
• insumer_acp_discountCheck 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.
• insumer_ucp_discountCheck 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.
• insumer_validate_codeValidate an INSR-XXXXX discount code. Returns validity, discount percent, expiry. Free, no auth.

What the code can do

Read from the published package source — never executed. Parsed 6 of 6 source files.

This server can make network requests and read your environment variables.

• Makes network requestsOpens network connections or calls fetch, so data it handles can leave your machine and it can pull data in.
• Reads environment variablesReads process.env. That is how it picks up the API keys you configure — and it is not restricted to only those variables.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

• Last commit today — Actively maintained.
• 2 GitHub stars — Very little community usage so far.

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

• Maintenance30%100%

  Last commit 0 days ago.

• Adoption20%14%

  2 stars.

• Transparency20%100%

  4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.

• Provenance15%100%

  Package and registry entry point at the same repository.

• Packaging15%100%

  Publishes a pinned version (1.23.1).

{
  "mcpServers": {
    "insumer": {
      "command": "npx",
      "args": ["-y", "mcp-server-insumer"],
      "env": {
        "INSUMER_API_KEY": "insr_live_..."
      }
    }
  }
}

{
  "insumer": {
    "command": "npx",
    "args": ["-y", "mcp-server-insumer"],
    "env": {
      "INSUMER_API_KEY": "insr_live_..."
    }
  }
}

Excerpt — the full document is on GitHub.

Maintain insumer? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

[![insumer on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/com-insumermodel-insumer)](https://mcp-skills-hub.vercel.app/mcps/com-insumermodel-insumer)