com.insumermodel/insumer
v1.24.0Wallet auth: send a wallet and conditions, get a signed boolean across 37 chains.
Endpoint health
online- Last checked
- 11/20/2026, 7:15:58 AM
- Latency
- 93 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.insumermodel%2Finsumer
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.insumermodel/insumer": {
"url": "https://api.insumermodel.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
10 shown · authentication unknown
Verify wallet conditions (signed)
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 of the wallet, such as a minimum token balance, ownership of an NFT, an attestation held or a registered agent ID; the type field on each condition lists the kinds available and the fields each one takes. Chains: EVM chains plus Solana, XRPL, Bitcoin, Tron, Stellar and Sui; Bitcoin, Tron, Stellar and Sui support token_balance only. The attestation is signed twice: ES256, with a kid identifying the key, and a post-quantum ML-DSA-65 signature (pqSig, pqKid). Each result includes evaluatedCondition, a SHA-256 conditionHash, and the block (EVM), ledger (XRPL, Stellar) or checkpoint (Sui) it was read at. An attestation expires 30 minutes after it is signed, or 5 minutes when it includes a delegation condition. Costs 1 credit (2 with proof: 'merkle'). An rpc_failure error (503) means a read did not complete and nothing was signed: retry, and never treat it as a no. Current chain and check counts: https://insumermodel.com/llms.txt On this hosted endpoint the call is paid from a shared daily allowance, so the caller is not charged; the credit cost above applies on the caller's own API key, and each result states the price on a key and by x402 pay-per-call.
Schema valid · SHA-256 fac699b03ec2…
View input schema
{ "type": "object", "properties": { "wallet": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "description": "EVM wallet address (0x...)" }, "solanaWallet": { "type": "string", "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$", "description": "Solana wallet address (base58)" }, "xrplWallet": { "type": "string", "pattern": "^r[1-9A-HJ-NP-Za-km-z]{24,34}$", "description": "XRPL wallet address (r-address). For verifying XRP, trust line tokens (RLUSD, USDC), or NFTs on XRP Ledger." }, "bitcoinWallet": { "type": "string", "pattern": "^(?:[13][1-9A-HJ-NP-Za-km-z]{25,34}|(?:bc1|BC1)[02-9ac-hj-np-zAC-HJ-NP-Z]{11,87})$", "description": "Bitcoin address (P2PKH, P2SH, bech32, or Taproot). For verifying native BTC balance. Use chainId 'bitcoin' with contractAddress 'native'." }, "tronWallet": { "type": "string", "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$", "description": "Tron wallet address (T-prefixed, base58). For verifying TRX or TRC20 tokens (USDT-TRC20). Use chainId 'tron'." }, "stellarWallet": { "type": "string", "pattern": "^G[A-Z2-7]{55}$", "description": "Stellar wallet address (G-prefixed). For verifying XLM or trustline assets (USDC, BENJI, etc.). Use chainId 'stellar' with the asset issuer's G-address as contractAddress and pass assetCode (e.g. 'USDC'). Soroban contract balances not visible; classic trustlines only." }, "suiWallet": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$", "description": "Sui wallet address (0x + 64 hex chars). For verifying SUI or other Sui coins (e.g. USDC). Use chainId 'sui' with the Sui coin type as contractAddress: '0x2::sui::SUI' for native SUI, or the full coin type address::module::Name for other coins. The string 'native' is not accepted on Sui." }, "proof": { "type": "string", "enum": [ "merkle" ], "description": "Set to 'merkle' for EIP-1186 Merkle proofs (2 credits, refunded to 1 when no proof is delivered). For token_balance or ratio_to_amount against an ERC-20, a storage proof of the balance slot (no subject field); for the same conditions with contractAddress 'native', an account proof whose balance field is the value evaluated (subject 'account_balance'); for account_code, an account proof whose codeHash is the value evaluated (subject 'account_code'); for erc7710_delegation, a storage proof of the revocation slot (subject 'delegation_revocation') on managers with an on-chain-verified layout. Supported EVM chains only (not ZKsync Era, Sei, Viction or XDC Network, and not on non-EVM chains)." }, "declaredLimits": { "type": "string", "enum": [ "omit" ], "description": "Set to 'omit' to leave decoded caveat limits out of the signed results of erc7710_delegation conditions, so a forwarded attestation does not carry the principal's spending ceiling. met, delegationHash, and conditionHash are byte-identical either way." }, "format": { "type": "string", "enum": [ "jwt" ], "description": "Set to 'jwt' to include a Wallet Auth by InsumerAPI token (ES256-signed JWT) in the response, with its ML-DSA-65 sibling pqJwt beside it. The jwt is verifiable by any standard JWT library using JWKS at /.well-known/jwks.json." }, "conditions": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "token_balance", "nft_ownership", "eas_attestation", "farcaster_id", "evm_view_call", "ratio_to_amount", "ratio_to_supply", "erc8004_agent", "erc7710_delegation", "account_code" ], "description": "Condition type: token_balance, nft_ownership (EVM, Solana and XRPL), eas_attestation, farcaster_id (Farcaster IdRegistry on Optimism), evm_view_call (single-address-argument view function returning bool; EVM chains only), ratio_to_amount (balance >= multiple * amount; EVM chains only), ratio_to_supply (balance / totalSupply >= minFraction; EVM chains, ERC-20 only), erc8004_agent (registered ERC-8004 agent on Base; agentId required), erc7710_delegation (signed MetaMask-framework delegation validity on Base; delegationManager, expectedDelegator, and delegation required; max 3 per request), or account_code (the code state of the wallet address itself on an EVM chain; expect required, delegate optional with expect 'eip7702'; no contractAddress)" }, "contractAddress": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[A-Za-z0-9:_]+$" }, { "type": "string", "maxLength": 600, "pattern": "^0x[0-9a-fA-F]{1,64}::[A-Za-z_][A-Za-z0-9_]*::[A-Za-z_][A-Za-z0-9_]*<[A-Za-z0-9:_<>, ]+>$" } ], "description": "Token or NFT contract address (required for token_balance, nft_ownership, ratio_to_amount, and ratio_to_supply; ratio_to_supply requires an ERC-20 contract, no native). 'native' means the chain's native coin and is for token_balance and ratio_to_amount only. Tempo (chainId 4217) has no native coin, so 'native' is rejected with a 400 there: pass the token's contract address. nft_ownership needs the NFT contract address (0x + 40 hex on EVM). On Solana it takes a verified collection address, which any NFT in that collection satisfies, or one NFT's mint address (or the asset ID of a compressed or Core NFT); an unverified collection tag never counts. 'native' with nft_ownership is rejected with a 400, so use token_balance for the native coin. On Sui, pass a coin type address::module::Name: native SUI is '0x2::sui::SUI', and 'native' is not accepted there. A coin type may carry type parameters in angle brackets." }, "chainId": { "anyOf": [ { "type": "integer", "description": "EVM chain ID" }, { "type": "string", "const": "solana" }, { "type": "string", "const": "xrpl" }, { "type": "string", "const": "bitcoin" }, { "type": "string", "const": "tron" }, { "type": "string", "const": "stellar" }, { "type": "string", "const": "sui" } ], "description": "Chain identifier: EVM chain ID (integer, includes 50 for XDC), 'solana', 'xrpl', 'bitcoin', 'tron', 'stellar', or 'sui'" }, "threshold": { "anyOf": [ { "type": "string", "maxLength": 80, "pattern": "^\\d+(\\.\\d+)?$" }, { "type": "number" } ], "description": "Minimum balance for token_balance, as a decimal string in token/display units (e.g. \"100\", not base units). Numbers are accepted and coerced to a string. Must be > 0 when proof is merkle." }, "multiple": { "$ref": "#/properties/conditions/items/properties/threshold", "description": "For ratio_to_amount: collateralization multiple as a decimal string (e.g. \"10\" for 'hold >= 10x the amount'). Met iff balance >= multiple * amount. Numbers are accepted and coerced. Must be > 0." }, "amount": { "$ref": "#/properties/conditions/items/properties/threshold", "description": "For ratio_to_amount: per-request reference amount in token/display units as a decimal string (e.g. \"100\" for 100 USDC, not base units/wei). Numbers are accepted and coerced. Must be > 0." }, "minFraction": { "$ref": "#/properties/conditions/items/properties/threshold", "description": "For ratio_to_supply: required share of total supply, a decimal string in (0,1] (e.g. \"0.005\" for 0.5%). Met iff balance / totalSupply() >= minFraction. Numbers are accepted and coerced. For project/governance tokens, not stablecoins." }, "decimals": { "type": "integer", "minimum": 0, "maximum": 77, "description": "Optional. Leave it out: the token's own decimals are always read from the chain. If sent it is only a cross-check, and a value that differs from the token's own decimals is rejected with a 400." }, "label": { "type": "string", "maxLength": 100, "description": "Human-readable label" }, "schemaId": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$", "description": "EAS schema ID (bytes32 hex). Required for eas_attestation unless template is provided." }, "attester": { "$ref": "#/properties/wallet", "description": "Expected attester address (optional, for eas_attestation)" }, "indexer": { "$ref": "#/properties/wallet", "description": "EAS indexer contract address (optional, for eas_attestation)" }, "template": { "type": "string", "enum": [ "coinbase_verified_account", "coinbase_verified_country", "coinbase_one", "gitcoin_passport_score", "gitcoin_passport_active" ], "description": "Compliance template name. Use instead of raw schemaId/attester/indexer for eas_attestation. Gitcoin Passport templates check Sybil resistance on Optimism." }, "currency": { "type": "string", "minLength": 1, "maxLength": 40, "pattern": "^[\\x20-\\x7E]+$", "description": "XRPL trust line currency code (e.g. 'RLUSD'). Case-sensitive: enter it exactly as the issuer created it. Required for XRPL trust line tokens, ignored for other chains." }, "assetCode": { "type": "string", "pattern": "^[A-Za-z0-9]{1,12}$", "description": "Stellar trustline asset code (e.g. 'USDC', 'BENJI'). Required for Stellar non-native (trustline) tokens. Use contractAddress 'native' for XLM. Ignored for other chains. Flows into conditionHash so different assets on the same issuer produce different hashes." }, "taxon": { "type": "integer", "minimum": 0, "maximum": 4294967295, "description": "XRPL NFToken taxon filter: an integer from 0 to 4294967295 (optional, for nft_ownership on XRPL only). Filters NFTs by issuer + taxon." }, "selector": { "type": "string", "maxLength": 100, "pattern": "^[A-Za-z_][A-Za-z0-9_]*\\(address\\)$", "description": "Required for evm_view_call. Canonical signature of a view function returning bool, in the form 'functionName(address)' (e.g. 'hasAccess(address)'). Single-address-argument view functions only; the 4-byte selector is derived from this signature." }, "agentId": { "type": "string", "pattern": "^\\d{1,78}$", "description": "Required for erc8004_agent. The ERC-8004 agent ID as a uint256 decimal string; the caller must supply it (the deployed Identity Registry has no wallet-to-agentId reverse lookup). Met iff the attested wallet owns the agent NFT (ownerOf) or is the registry's signature-verified agentWallet binding. Registry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 on Base; chainId 8453 only. Honest semantics: registration is permissionless minting, so the signed statement implies no vetting, no reputation, no endorsement." }, "expect": { "type": "string", "enum": [ "none", "eip7702", "contract" ], "description": "Required for account_code: the code state the wallet address itself must be in at the anchored block. 'none' is no code (a plain key account); 'eip7702' is the EIP-7702 delegation designator (a key that has delegated execution to a contract); 'contract' is any other code (a smart-contract wallet, a protocol, a token). The three states are exclusive on a chain. EVM chains only; a non-EVM chainId is rejected with a 400. The result is met or not met, like every type: the code and the delegation target are never returned, in any format or mode. The signed evaluatedCondition is {type, chainId, expect, operator: 'code_state'}. With proof 'merkle', the proof is an EIP-1186 account proof (subject 'account_code') whose codeHash is the proven value." }, "delegate": { "$ref": "#/properties/wallet", "description": "For account_code with expect 'eip7702' only (a 400 with any other expect): an EVM address; met iff the wallet's EIP-7702 designator points at it. Echoed in lowercase inside the signed evaluatedCondition as the caller's input; the actual delegation target is never returned." }, "delegationManager": { "$ref": "#/properties/wallet", "description": "Required for erc7710_delegation. DelegationManager contract the delegation was signed against: one of the recognized MetaMask Delegation Framework managers on Base (current default 0xdb9B1e94B5b69Df7e401DDbedE43491141047dB3). chainId 8453 only." }, "expectedDelegator": { "$ref": "#/properties/wallet", "description": "Required for erc7710_delegation. The principal address the caller asserts authorized this agent. The condition fails unless the delegation's declared delegator matches. Without it a self-delegation would read as authority, so there is no structural-only mode." }, "delegation": { "type": "object", "properties": { "delegator": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "description": "Principal address that signed the delegation. Must equal expectedDelegator." }, "delegate": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "description": "Agent wallet the delegation authorizes. Must equal the attested wallet." }, "authority": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$", "description": "Root authority only (0xffff…ffff, 32 bytes of 0xff). Delegation chains are unsupported." }, "caveats": { "type": "array", "items": { "type": "object", "properties": { "enforcer": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "description": "Caveat enforcer contract address" }, "terms": { "type": "string", "maxLength": 20000, "pattern": "^0x[0-9a-fA-F]*$", "description": "ABI-encoded caveat terms (hex)" } }, "required": [ "enforcer", "terms" ], "additionalProperties": false }, "maxItems": 16, "description": "Caveats the principal signed (max 16). Every enforcer must be recognized or the condition fails, with no override." }, "salt": { "anyOf": [ { "$ref": "#/properties/conditions/items/properties/agentId" }, { "type": "integer", "minimum": 0 } ], "description": "Delegation salt (decimal string; numbers coerced)" }, "signature": { "type": "string", "maxLength": 20000, "pattern": "^0x[0-9a-fA-F]*$", "description": "EIP-712 signature over the delegation (hex). EOA recovery, or ERC-1271 for smart-contract principals." } }, "required": [ "delegator", "delegate", "authority", "caveats", "salt", "signature" ], "additionalProperties": false, "description": "Required for erc7710_delegation. The signed ERC-7710 delegation to evaluate. Met iff ALL of: attested wallet is the delegate; declared delegator is expectedDelegator; EIP-712 signature verifies (EOA or ERC-1271); unrevoked at the anchored block; every caveat enforcer recognized; any time-window caveat currently satisfied. Recognized enforcers: timestamp (evaluated), erc20_transfer_amount, native_transfer_amount, allowed_targets, limited_calls (the last four are REPORTED as declaredLimits: redemption enforces them, the attestation does not simulate enforcement). A delegation result that is not met carries failReason, and an attestation that includes a delegation condition expires in 5 minutes instead of 30." } }, "required": [ "type" ], "additionalProperties": false }, "minItems": 1, "maxItems": 10, "description": "The list of 1 to 10 conditions to evaluate. All of them are read in this one call and covered by the one signed attestation." } }, "required": [ "conditions" ], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" }
Connections
streamable-http
https://api.insumermodel.com/mcp