douglasborthwick-crypto/mcp-server-insumer

douglasborthwick-crypto/mcp-server-insumer

от douglasborthwick-crypto
MCP-сервер InsumerAPI для проверки on-chain условий на 37 блокчейнах (балансы токенов, NFT, Farcaster, EAS-аттестации). Возвращает ECDSA-подписанный boolean без раскрытия балансов. Помогает AI-аген...

mcp-server-insumer

npm Glama License: MIT

MCP server for InsumerAPI — condition-based access infrastructure. Send a wallet and conditions, get a signed boolean across 37 chains. No balances exposed, no identity required, no trust in the API provider needed.

Enables AI agents (Claude Desktop, Cursor, Windsurf, and any MCP-compatible client) to add condition-based access to any workflow — verify on-chain conditions, discover merchants, generate signed discount codes, and onboard new merchants.

In production: AsterPay — a regulated payments stack — runs live ERC-8183 agentic-commerce trust scoring on InsumerAPI. Case study.

Also available as: LangChain (26 tools, PyPI) | langchain-community (26 tools, PR #549) | ElizaOS (10 actions, npm) | OpenAI GPT (GPT Store) | insumer-verify (client-side verification, npm)

Full AI Agent Verification API guide — covers all 37 chains, trust profiles, commerce protocols, and signature verification.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "insumer": {
      "command": "npx",
      "args": ["-y", "mcp-server-insumer"],
      "env": {
        "INSUMER_API_KEY": "insr_live_..."
      }
    }
  }
}
Инструменты были проиндексированы:
insumer_acp_discount

Проверяет право держателя токенов на скидку в формате OpenAI/Stripe Agentic Commerce Protocol (ACP). Возвращает объекты купонов, массивы применённых/отклонённых позиций и распределение по элементам, совместимое с потоком оформления заказа в ACP. Та же цепочечная верификация, что и в insumer_verify, но обёрнута в формат ACP. Расходует 1 кредит продавца.

Параметры
  • itemsobject[]

    Optional line items for per-item cent-amount allocations

  • merchantIdstringобязательный

    Merchant ID

  • solanaWalletstring

    Solana wallet address (base58)

  • stellarWalletstring

    Stellar wallet address (G-prefixed)

  • suiWalletstring

    Sui wallet address (0x + 64 hex)

  • tronWalletstring

    Tron wallet address (T-prefixed)

  • walletstring

    EVM wallet address (0x...)

  • xrplWalletstring

    XRPL wallet address (r-address)

insumer_attest

Создаёт ончейн-верификацию (аттестацию). Проверяет 1-10 условий (балансы токенов, владение NFT, аттестации EAS, идентификацию Farcaster, соотношения supply/amount) на 37 блокчейнах (31 EVM + Solana + XRPL + Bitcoin + Tron + Stellar + Sui). Возвращает ECDSA-подписанные логические результаты с полем kid, идентифицирующим ключ подписи (публичный ключ получается через insumer_jwks). Никогда не раскрывает фактические балансы. Каждый результат включает evaluatedCondition (проверенная логика), conditionHash (SHA-256 для защиты от подделки) и blockNumber/blockTimestamp для RPC-цепей (свежесть). Результаты XRPL включают ledgerIndex и ledgerHash вместо blockNumber/blockTimestamp; результаты trust-линий также включают trustLineState: { frozen: boolean }. Результаты Stellar включают ledgerIndex и ledgerHash и отображают assetCode (который попадает в conditionHash для привязки ненативных ассетов). Результаты Sui включают checkpointSequence и checkpointDigest. Стандартный режим стоит 1 кредит. Передайте доказательство: 'merkle' для доказательств хранения Merkle по EIP-1186 (2 кредита). Для аттестаций EAS используйте шаблон соответствия (Coinbase Verifications, Gitcoin Passport) или raw schemaId. Для Farcaster используйте тип 'farcaster_id' (проверяет IdRegistry на Optimism). Для самомасштабируемых лимитов расходов агента используйте тип 'ratio_to_amount' (выполнено, если balance >= multiple * amount; только RPC EVM-цепи). Для правил доли от предложения используйте тип 'ratio_to_supply' (выполнено, если balance / totalSupply >= minFraction, дробь в (0,1]; только RPC EVM-цепи, ERC-20). Используйте insumer_compliance_templates для просмотра доступных шаблонов.

Параметры
  • bitcoinWalletstring

    Bitcoin address (P2PKH, P2SH, bech32, or Taproot). For verifying native BTC balance. Use chainId 'bitcoin' with contractAddress 'native'.

  • conditionsobject[]обязательный

    1-10 on-chain conditions to verify

  • declaredLimitsenum

    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.

  • formatenum

    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.

  • proofenum

    Set to 'merkle' for EIP-1186 Merkle storage proofs (2 credits). Available for token_balance on RPC EVM chains, and for erc7710_delegation as a storage proof of the revocation slot (subject 'delegation_revocation'; managers with an on-chain-verified layout only — currently the v1.3.0 manager on Base).

  • solanaWalletstring

    Solana wallet address (base58)

  • stellarWalletstring

    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.

  • suiWalletstring

    Sui wallet address (0x + 64 hex chars). For verifying SUI or Sui-native tokens (USDC). Use chainId 'sui' with the fully-qualified type string as contractAddress (e.g. '0xdba34672...::usdc::USDC').

  • tronWalletstring

    Tron wallet address (T-prefixed, base58). For verifying TRX or TRC20 tokens (USDT-TRC20). Use chainId 'tron'.

  • walletstring

    EVM wallet address (0x...)

  • xrplWalletstring

    XRPL wallet address (r-address). For verifying XRP, trust line tokens (RLUSD, USDC), or NFTs on XRP Ledger.

insumer_batch_wallet_trust

Генерирует профили фактов доверия для кошельков — до 10 кошельков за один запрос. Общие загрузки блоков делают это в 5-8 раз быстрее последовательных вызовов. Каждый кошелек получает независимо подписанный через ECDSA профиль с собственным идентификатором TRST-XXXXX. Поддерживает частичный успех: для неудачных кошельков возвращаются записи об ошибках, а для успешных — полные профили. Стоит 3 кредита за каждый успешный кошелек (стандартный) или 6 кредитов за кошелек (доказательство: 'merkle'). Кредиты списываются только за успешные профили.

Параметры
  • proofenum

    Set to 'merkle' for EIP-1186 Merkle storage proofs on all wallets (6 credits/wallet).

  • walletsobject[]обязательный

    1-10 wallet entries to profile

insumer_buy_credits

Покупайте кредиты верификации за USDC, USDT, BTC или USDT-TRC20. Скидки за объём: $5–$99 = $0,04 за вызов (25 кредитов/$1), $100–$499 = $0,03 (33 кредита/$1, скидка 25%), $500+ = $0,02 (50 кредитов/$1, скидка 50%). Минимальная сумма $5. USDC/USDT на EVM и Solana (определяется автоматически). USDT-TRC20 на Tron. BTC на Bitcoin (конвертируется в USD по рыночному курсу, требуется 1 подтверждение). Криптовалюта, отправленная на неподдерживаемые цепочки, не подлежит восстановлению. Возврат не предусмотрен. При первой покупке кошелёк отправителя регистрируется для данного API-ключа. Последующие покупки должны поступать с того же кошелька. Чтобы сменить зарегистрированный кошелёк, установите updateWallet в true.

Параметры
  • amountnumber

    Stablecoin amount sent (minimum 5). Not required for BTC.

  • chainIdenum | integer | stringобязательный

    Payment chain: 1, 8453, 137, 42161, 10, 56, 43114, 'solana', 'bitcoin', or 'tron'. EVM/Solana accept USDC and USDT (auto-detected). Bitcoin accepts BTC (converted to USD at market rate). Tron accepts USDT-TRC20.

  • txHashstringобязательный

    Transaction hash proving payment

  • updateWalletboolean

    Set true to update the registered sender wallet to this transaction's sender

insumer_buy_key

Купите новый API-ключ за USDC, USDT, BTC или USDT-TRC20 (регистрация не нужна). Для агентов: почта не требуется. Отправляйте USDC/USDT на EVM-кошелёк 0xAd982CB19aCCa2923Df8F687C0614a7700255a23 или Solana-кошелёк 6a1mLjefhvSJX1sEX8PTnionbE9DqoYjU6F6bNkT4Ydr. USDT-TRC20 отправляйте на Tron-кошелёк TC5yvwkAMakkXtUxYiu2Yn1xbBcwYuD6cn. BTC отправляйте на bc1qg7qnerdhlmdn899zemtez5tcx2a2snc0dt9dt0 (требуется 1 подтверждение). USDC/USDT определяются автоматически по транзакции. BTC конвертируется в USD по рыночному курсу. Один ключ на один кошелёк — для пополнения используйте insumer_buy_credits. Скидки за объём: $5–$99 = $0.04/вызов, $100–$499 = $0.03, $500+ = $0.02. Возврату не подлежит.

Параметры
  • amountnumber

    Stablecoin amount sent (minimum 5). Not required for BTC — USD value derived from on-chain amount at market rate.

  • appNamestringобязательный

    Name for the API key (e.g. your agent or app name)

  • chainIdenum | integer | stringобязательный

    Payment chain: 1, 8453, 137, 42161, 10, 56, 43114, 'solana', 'bitcoin', or 'tron'. EVM/Solana accept USDC and USDT (auto-detected). Bitcoin accepts BTC (converted to USD at market rate). Tron accepts USDT-TRC20.

  • txHashstringобязательный

    Transaction hash proving payment

insumer_buy_merchant_credits

Купите кредиты для верификации мерчанта за USDC, USDT, BTC или USDT-TRC20. Скидки за объём: $5–$99 = $0,04/вызов (25/$1), $100–$499 = $0,03 (33/$1), $500+ = $0,02 (50/$1). Минимум $5. USDC/USDT на EVM и Solana (определяется автоматически). USDT-TRC20 на Tron. BTC на Bitcoin (конвертируется в USD по рыночному курсу, требуется 1 подтверждение). Невозвратные. Только владелец. При первой покупке кошелёк отправителя регистрируется для данного API-ключа. Чтобы сменить зарегистрированный кошелёк, установите updateWallet в true.

Параметры
  • amountnumber

    Stablecoin amount sent (minimum 5). Not required for BTC.

  • chainIdenum | integer | stringобязательный

    Payment chain: 1, 8453, 137, 42161, 10, 56, 43114, 'solana', 'bitcoin', or 'tron'. EVM/Solana accept USDC and USDT (auto-detected). Bitcoin accepts BTC (converted to USD at market rate). Tron accepts USDT-TRC20.

  • idstringобязательный

    Merchant ID

  • txHashstringобязательный

    Transaction hash proving payment

  • updateWalletboolean

    Set true to update the registered sender wallet

insumer_check_discount

Рассчитывает скидку для кошелька у мерчанта. Проверяет балансы на блокчейне и возвращает уровень и процент скидки на каждый токен - никогда не возвращает сырые суммы балансов. Бесплатно - не расходует кредиты.

Параметры
  • merchantstringобязательный

    Merchant ID

  • solanaWalletstring

    Solana wallet address (base58)

  • stellarWalletstring

    Stellar wallet address (G-prefixed)

  • suiWalletstring

    Sui wallet address (0x + 64 hex)

  • tronWalletstring

    Tron wallet address (T-prefixed)

  • walletstring

    EVM wallet address (0x...)

  • xrplWalletstring

    XRPL wallet address (r-address)

insumer_compliance_templates

Выводит список доступных шаблонов соответствия для проверки аттестаций EAS. Шаблоны содержат предварительно настроенные идентификаторы схем, адреса аттестаторов и контракты декодера для KYC-провайдеров (Coinbase Verifications на Base, Gitcoin Passport на Optimism). Используйте имя шаблона в условиях insumer_attest вместо указания сырых параметров EAS. Аутентификация и кредиты не требуются.

Параметры

Без параметров.

insumer_configure_nfts

Настройка коллекций NFT, дающих скидки у продавца. Максимум 4 коллекции. Только владелец.

Параметры
  • idstringобязательный

    Merchant ID

  • nftCollectionsobject[]обязательный

    NFT collection configurations (0-4)

insumer_configure_settings

Обновить настройки мерчанта: режим суммирования скидок, лимит и конфигурация оплаты в стейблкоинах. Все поля опциональны. Только владелец.

Параметры
  • discountCapinteger

    Maximum total discount percentage (1-100)

  • discountModeenum

    'highest' uses best single discount, 'stack' adds them together, 'capped' stacks up to discountCap

  • idstringобязательный

    Merchant ID

  • usdcPaymentobject | null

    USDC payment settings, or null to disable

insumer_configure_tokens

Настроить уровни скидок для токенов мерчанта. Установить собственный токен и/или партнёрские токены. Максимум 8 токенов всего. Только владелец.

Параметры
  • idstringобязательный

    Merchant ID

  • ownTokenobject | null

    Merchant's own token configuration, or null to remove

  • partnerTokensany[]

    Partner token configurations

insumer_confirm_payment

Подтверждает платеж в стейблкоинах для получения промокода. Вызывает insumer_verify и проверяет, что платеж в USDC/USDT выполнен в блокчейне. Сервер проверяет квитанцию транзакции.

Параметры
  • amountstring | numberобязательный

    Stablecoin amount sent

  • chainIdenum | integer | stringобязательный

    Payment chain: EVM chain ID (1, 8453, 137, 42161, 10, 56, 43114), 'solana', or 'tron'

  • codestringобязательный

    Verification code from insumer_verify (e.g. INSR-A7K3M)

  • txHashstringобязательный

    On-chain transaction hash or Solana signature

insumer_create_merchant

Создать нового мерчанта. Получает 100 бесплатных верификационных кредитов. API-ключ, создавший мерчанта, владеет им. Максимум 10 мерчантов на один API-ключ.

Параметры
  • companyIdstringобязательный

    Unique merchant ID (alphanumeric, dashes, underscores)

  • companyNamestringобязательный

    Company display name

  • locationstring

    City or region

insumer_credits

Проверяет баланс кредитов верификации, уровень (free/pro/enterprise) и дневной лимит запросов для текущего API key.

Параметры

Без параметров.

insumer_get_merchant

Получить полный публичный профиль продавца, включая уровни токенов, коллекции NFT, режим скидок и статус верификации.

Параметры
  • idstringобязательный

    Merchant ID

insumer_jwks

Получите JWKS (JSON Web Key Set): пять записей для двух ключей. Ключ ECDSA P-256 под kid insumer-attest-v1, insumer-attest-v2 и insumer-trust-v2, далее постквантовый ключ ML-DSA-65 в двух записях AKP по RFC 9964: insumer-attest-pq1 и insumer-trust-pq1. Используйте это для проверки подписей аттестации и доверия, не зашивая ключ в код. Сопоставляйте запись по kid (или pqKid) в ответе, никогда не по позиции; неизвестный kid означает, что подпись невозможно проверить, но она не опровергнута. Аутентификация не требуется.

Параметры

Без параметров.

insumer_list_merchants

Просматривает продавцов в публичном каталоге. Фильтрует по принимаемому токену, статусу верификации. Возвращает название компании, веб-сайт, принимаемые токены и информацию о скидках.

Параметры
  • limitinteger

    Results per page (default 50, max 200)

  • offsetinteger

    Pagination offset (default 0)

  • tokenstring

    Filter by accepted token symbol, e.g. 'UNI'

  • verifiedenum

    Filter by domain verification status

insumer_list_tokens

Выведите список всех зарегистрированных токенов и NFT-коллекций в реестре Insumer. Отфильтруйте по сети, символу или типу актива.

Параметры
  • chaininteger | string

    Filter by chain ID

  • symbolstring

    Filter by token symbol

  • typeenum

    Filter by asset type

insumer_merchant_status

Получить полные приватные данные о магазине: кредиты, конфигурации токенов, коллекции NFT, статус в каталоге, статус верификации, настройки платежей. Только для владельца.

Параметры
  • idstringобязательный

    Merchant ID

insumer_publish_directory

Опубликовать (или обновить) запись торговца в публичном каталоге. Вызовите снова после обновления токенов или настроек. Только владелец.

Параметры
  • idstringобязательный

    Merchant ID

insumer_request_domain_verification

Запрашивает токен верификации домена для мерчанта. Возвращает токен и три метода верификации: DNS TXT запись, HTML meta-тег или загрузка файла. После размещения токена вызовите insumer_verify_domain, чтобы завершить верификацию. Верифицированные мерчанты получают значок доверия в публичном каталоге. Только владелец.

Параметры
  • domainstringобязательный

    Domain to verify (e.g. 'example.com')

  • idstringобязательный

    Merchant ID

insumer_setup

Генерирует бесплатный ключ InsumerAPI мгновенно. Кредитная карта не требуется. Возвращает ключ API (insr_live_...) с 10 кредитами на верификацию и 100 вызовами в день. Пользователь должен добавить ключ в свою конфигурацию MCP как INSUMER_API_KEY и перезапустить. Один бесплатный ключ на email, 3 на IP в день.

Параметры
  • appNamestring

    Name of your app or project (default: 'MCP Agent')

  • emailstringобязательный

    Email address for the API key

insumer_ucp_discount

Проверяет, имеет ли держатель токена право на скидку в формате Google Universal Commerce Protocol (UCP). Возвращает title, extension field и массив applied, совместимые с процессом оформления заказа UCP. Та же проверка в цепочке, что и insumer_verify, но обёрнутая в формат UCP. Расходует 1 кредит мерчанта.

Параметры
  • itemsobject[]

    Optional line items for per-item cent-amount allocations

  • merchantIdstringобязательный

    Merchant ID

  • solanaWalletstring

    Solana wallet address (base58)

  • stellarWalletstring

    Stellar wallet address (G-prefixed)

  • suiWalletstring

    Sui wallet address (0x + 64 hex)

  • tronWalletstring

    Tron wallet address (T-prefixed)

  • walletstring

    EVM wallet address (0x...)

  • xrplWalletstring

    XRPL wallet address (r-address)

insumer_validate_code

Проверяет код скидки INSR-XXXXX. Используется в бэкендах мерчантов при оформлении заказа через ACP/UCP, чтобы подтвердить корректность кода, процент скидки и срок действия. Возвращает статус valid/invalid с причиной. Аутентификация не требуется, кредиты не расходуются. Не раскрывает данные кошелька или токена.

Параметры
  • codestringобязательный

    Discount code in INSR-XXXXX format

insumer_verify

Создаёт подписанный код скидки (INSR-XXXXX, срок действия 30 минут) для кошелька у продавца. Возвращает уровень и процент скидки, никогда не возвращает суммы баланса. Расходует 1 кредит продавца. Если у продавца есть Stripe Connect, купон создаётся автоматически.

Параметры
  • merchantIdstringобязательный

    Merchant ID

  • solanaWalletstring

    Solana wallet address (base58)

  • stellarWalletstring

    Stellar wallet address (G-prefixed)

  • suiWalletstring

    Sui wallet address (0x + 64 hex)

  • tronWalletstring

    Tron wallet address (T-prefixed)

  • walletstring

    EVM wallet address (0x...)

  • xrplWalletstring

    XRPL wallet address (r-address)

insumer_verify_domain

Проверяет владение доменом для мерчанта. Вызывайте после размещения токена верификации (из insumer_request_domain_verification) через DNS TXT запись, HTML мета-тег или загрузку файла. Сервер проверяет все три метода автоматически. Лимит: 5 попыток в час. Только владелец.

Параметры
  • idstringобязательный

    Merchant ID

insumer_wallet_trust

Генерирует структурированный профиль фактов доверия кошелька с подписью ECDSA. Отправьте адрес EVM-кошелька и получите 44 базовые проверки по 25 сетям в 5 измерениях: стейблкоины (USDC + USDT в 21 EVM-сети), управление (UNI, AAVE, ARB, OP), NFT (BAYC, Pudgy Penguins, Wrapped CryptoPunks), стейкинг (stETH, rETH, cbETH) и институциональные стейблкоины (EURCV, USDCV, USDC и BENJI в сетях Ethereum, Solana, XRPL, Stellar и Sui — кроссчейн-записи оцениваются, если предоставлен соответствующий дополнительный кошелек). Добавьте опциональные кошельки Solana, XRPL, Bitcoin и Tron, чтобы увеличить количество проверок до 49 по 27 сетям в 9 измерениях (добавляются Solana USDC, XRPL RLUSD + USDC, нативные запасы BTC и Tron USDT-TRC20). Возвращает количество пройденных/не пройденных проверок по каждому измерению и общую сводку — никаких оценок, никаких мнений, только криптографически проверяемые доказательства, сгруппированные по измерениям. Разработано для принятия решений о доверии между AI-агентами. Стоимость: 3 кредита (стандартно) или 6 кредитов (с доказательством: 'merkle').

Параметры
  • bitcoinWalletstring

    Bitcoin address. If provided, adds Bitcoin Holdings dimension (native BTC balance check).

  • proofenum

    Set to 'merkle' for EIP-1186 Merkle storage proofs on stablecoin/governance checks (6 credits).

  • solanaWalletstring

    Solana wallet address (base58). If provided, adds USDC on Solana and institutional EURCV/USDCV on Solana checks.

  • stellarWalletstring

    Stellar wallet address (G-prefixed). If provided, adds institutional USDC and BENJI on Stellar checks (classic trustlines).

  • suiWalletstring

    Sui wallet address (0x + 64 hex). If provided, adds institutional USDC on Sui check.

  • tronWalletstring

    Tron wallet address (T-prefixed). If provided, adds USDT-TRC20 on Tron check.

  • walletstringобязательный

    EVM wallet address (0x...) to profile

  • xrplWalletstring

    XRPL wallet address (r-address). If provided, adds RLUSD, USDC, and institutional EURCV on XRPL checks.

Похожие MCP-сервера

bankless/onchain-mcp

bankless/onchain-mcp

официальный

MCP-сервер для доступа к on-chain данным через Bankless API. Позволяет AI-моделям читать контракты, получать события и транзакции на разных сетях. Полезен разработчикам блокчейн-приложений и AI-аге...

TypeScript80
sei-protocol/sei-mcp-server

sei-protocol/sei-mcp-server

MCP сервер для Sei блокчейна, который даёт AI-агентам доступ к данным on-chain, смарт-контрактам и токенам. Включает балансы, транзакции, переводы ERC20 и NFT - всё через единый интерфейс.

TypeScript13
Chronolapse411/sicarius-guard

Chronolapse411/sicarius-guard

MCP сервер SicariusGuard выполняет 12-слойную проверку безопасности Solana-токенов и NFT: on-chain (mint, freeze, honeypot), LP lock, возраст, рыночные данные, репутация deployer. Создан для AI-агентов и торговых роботов.

TypeScript2
alchemy/alchemy-mcp-server

alchemy/alchemy-mcp-server

официальный

MCP-сервер для AI-агентов, работающий с блокчейн-данными Alchemy. Позволяет запрашивать цены токенов, NFT, историю транзакций и балансы на нескольких сетях, а также отправлять транзакции и выполнят...

TypeScript88
Bichev/agentradar-mcp

Bichev/agentradar-mcp

MCP сервер для AgentRadar — on-chain оракул доверия для экономики агентов. Включает 18 инструментов: верификация, сравнение, скоринг, проверка на скам, on-chain аттестация и другие. Работает из Claude, Cursor и любых MCP-клиентов.

TypeScript1
tumf/web3-mcp

tumf/web3-mcp

MCP-сервер для доступа к блокчейн данным через Ankr Advanced API. Поддерживает Ethereum, BSC, Polygon и другие сети. Позволяет получать NFT метаданные, балансы токенов, транзакции и статистику блоков. Полезен разработчикам Web3 и DeFi-приложений.

Python9
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин