# insumer MCP server

Wallet auth: send a wallet and conditions, get a signed boolean across 37 chains.

## At a glance

insumer is an MCP server in the Other category. It runs locally over stdio via `npx -y mcp-server-insumer`, and needs INSUMER_API_KEY and INSUMER_PAYMENT_KEY. It exposes 27 tools, including insumer_setup, insumer_jwks and insumer_attest. It scores A (83/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install insumer in Claude Code

1. Add the server

```bash
claude mcp add insumer -e 'INSUMER_API_KEY=<INSUMER_API_KEY>' -e 'INSUMER_PAYMENT_KEY=<INSUMER_PAYMENT_KEY>' -- npx -y mcp-server-insumer
```

2. Fill in your credentials

   Replace <INSUMER_API_KEY>, <INSUMER_PAYMENT_KEY> with your real values. Keep secrets out of any config file you commit.

3. Verify it's connected

```bash
claude mcp list
```

4. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

5. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. insumer_setup, insumer_jwks, insumer_attest). It discovers them automatically.

### How to install insumer in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

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

3. Fill in your credentials

   Replace <INSUMER_API_KEY>, <INSUMER_PAYMENT_KEY> with your real values. Keep secrets out of any config file you commit.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install insumer in Cursor

1. Create / edit .cursor/mcp.json in your project

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

2. Fill in your credentials

   Replace <INSUMER_API_KEY>, <INSUMER_PAYMENT_KEY> with your real values. Keep secrets out of any config file you commit.

3. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install insumer in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.insumer]
command = "npx"
args = ["-y", "mcp-server-insumer"]
env = { INSUMER_API_KEY = "<INSUMER_API_KEY>", INSUMER_PAYMENT_KEY = "<INSUMER_PAYMENT_KEY>" }
```

2. Fill in your credentials

   Replace <INSUMER_API_KEY>, <INSUMER_PAYMENT_KEY> with your real values. Keep secrets out of any config file you commit.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install insumer in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

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

2. Fill in your credentials

   Replace <INSUMER_API_KEY>, <INSUMER_PAYMENT_KEY> with your real values. Keep secrets out of any config file you commit.

3. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install insumer in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

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

3. Fill in your credentials

   Replace <INSUMER_API_KEY>, <INSUMER_PAYMENT_KEY> with your real values. Keep secrets out of any config file you commit.

### How to install insumer in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "insumer": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-insumer"
      ],
      "env": {
        "INSUMER_API_KEY": "<INSUMER_API_KEY>",
        "INSUMER_PAYMENT_KEY": "<INSUMER_PAYMENT_KEY>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace <INSUMER_API_KEY>, <INSUMER_PAYMENT_KEY> with your real values. Keep secrets out of any config file you commit.

3. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `insumer_setup` — Generate 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_jwks` — Get 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_attest` — Verify 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_templates` — List available EAS compliance templates (Coinbase Verifications on Base, Gitcoin Passport on Optimism). Free.
- `insumer_wallet_trust` — 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, accoun
- `insumer_batch_wallet_trust` — Batch 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_verify` — 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
- `insumer_list_merchants` — Browse the merchant directory. Filter by token, verification status.
- `insumer_get_merchant` — Get full public merchant profile.
- `insumer_list_tokens` — 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.
- `insumer_check_discount` — Calculate discount for a wallet at a merchant.
- `insumer_buy_key` — 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 (`senderSignature`; a call without it returns the text). One key per wa
- `insumer_credits` — Check credit balance and tier.
- `insumer_buy_credits` — Buy 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_payment` — Confirm USDC payment for a discount code.
- `insumer_create_merchant` — Create 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_status` — Get full private merchant details.
- `insumer_configure_tokens` — Set 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_nfts` — Set 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_settings` — Set discount mode, cap, the terms for wallets without proof of control, USDC payments.
- `insumer_publish_directory` — Publish merchant to public directory.
- `insumer_buy_merchant_credits` — 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 (`insumer_buy_credits` has the volume tiers). `amount` required, m
- `insumer_request_domain_verification` — Request a verification token for a merchant's domain. Returns token and 3 methods (DNS TXT, meta tag, file upload).
- `insumer_verify_domain` — Complete domain verification after placing the token. Verified merchants get a trust badge.
- `insumer_acp_discount` — 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.
- `insumer_ucp_discount` — 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.
- `insumer_validate_code` — Validate an INSR-XXXXX discount code. Returns validity, discount percent, expiry. Free, no auth.

Source repository: https://github.com/insumerapi/mcp-server-insumer

---

Source: https://mcp-skills-hub.vercel.app/mcps/com-insumermodel-insumer · MCP Skills Hub · data as of 2026-10-28T12:31:05Z