MCP Server
Averis Protocol
io.github.mosaro0224/averis-protocol
What this MCP does
Provides on-chain working-capital financing for autonomous agents, including eligibility checks, financing quotes, spending pool status, and repayment calldata.
Capabilities
Tools
22
tools
averis_check_eligibility
Check Agent Eligibility
Check whether an agent address is eligible for financing. Returns credit limit, current exposure, available credit, active job count, and remaining job slots.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string', 'description': 'Agent wallet address (0x...)'}}}
averis_discover
Discover Averis Protocol
Discover Averis Protocol capabilities, contract addresses, financing parameters, authentication requirements, and the complete agent journey. Call this first to understand how to interact with Averis.
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}}
averis_get_quote
Get Financing Quote
Get a financing quote for a job. Returns the approved amount, financing fee, total repayment obligation, and the on-chain calldata the agent must submit to create the spending pool.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['agentAddress', 'protocol', 'jobId', 'requestedAmount'], 'properties': {'jobId': {'type': 'string', 'description': 'Job ID as a decimal string'}, 'protocol': {'type': 'string', 'description': 'Job protocol contract address'}, 'agentAddress': {'type': 'string', 'description': 'Agent wallet address'}, 'requestedAmount': {'type': 'string', 'description': 'Requested USDC amount in raw units (6 decimals)'}}}
averis_passport_prepare_mint
Prepare Identity Mint Transaction
Get unsigned calldata to mint an ERC-8004 identity token on Arc Testnet or Robinhood Chain Testnet (or both). The API returns a ready-to-broadcast unsigned transaction. The agent signs it from their own wallet and broadcasts it — the API never holds a key. Call averis_passport_verify_identity first to confirm identity does not already exist.
Input schema
{'type': 'object', 'required': ['wallet', 'agentId', 'metadataURI', 'chainId'], 'properties': {'wallet': {'type': 'string', 'description': 'Agent wallet address that will own the identity (0x...)'}, 'agentId': {'type': 'integer', 'description': 'ERC-8004 token ID to mint (must be unique on the target chain)'}, 'chainId': {'type': 'integer', 'description': 'Target chain: 5042002 (Arc Testnet) or 46630 (Robinhood Chain Testnet)'}, 'metadataURI': {'type': 'string', 'description': 'URI pointing to agent metadata JSON (IPFS link or HTTPS URL)'}}}
averis_passport_prepare_policy_commit
Prepare Policy Commit Transaction
Get unsigned calldata to commit a capability policy hash to AgentPolicyRegistry on Robinhood Chain Testnet (chain 46630). Returns a ready-to-broadcast unsigned transaction. The agent signs and broadcasts from their own wallet. Policy commitments are irreversible once confirmed onchain.
Input schema
{'type': 'object', 'required': ['wallet', 'agentId', 'policyHash'], 'properties': {'wallet': {'type': 'string', 'description': 'Agent wallet address (0x...)'}, 'agentId': {'type': 'integer', 'description': 'ERC-8004 token ID of the agent committing the policy'}, 'expiresAt': {'type': 'integer', 'description': 'Unix timestamp when policy expires (0 = no expiry)'}, 'policyHash': {'type': 'string', 'description': 'keccak256 hash of the policy document (bytes32, 0x-prefixed)'}, 'contentURIHash': {'type': 'string', 'description': 'keccak256 hash of the IPFS content URI (bytes32, 0x-prefixed, optional)'}}}
averis_passport_verify_identity
Verify Agent Identity
Check whether an agent wallet has a registered ERC-8004 identity on Arc Testnet and/or Robinhood Chain Testnet. Returns per-chain identity records, a verified boolean, and verifiedChains array. No auth required — anyone can verify any wallet.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'wallet': {'type': 'string', 'description': 'Agent wallet address (0x...)'}, 'agentId': {'type': 'integer', 'description': 'ERC-8004 token ID (optional — provide wallet or agentId or both)'}, 'chainId': {'type': 'integer', 'description': 'Specific chain to check: 5042002 (Arc) or 46630 (Robinhood). Omit to check both.'}}}
averis_pool_status
Spending Pool Status
Get the current state of a job-specific spending pool: balance, amount spent, per-transaction limit, allowed recipients, expiry, and frozen status.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['poolAddress'], 'properties': {'poolAddress': {'type': 'string', 'description': 'Spending pool contract address (from position.poolAddress)'}}}
averis_position_status
Financing Position Status
Get the financing position for a job: principal, fee, repayment status, pool address, and whether the position is active, repaid, or in default.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['jobId'], 'properties': {'jobId': {'type': 'string', 'description': 'Job ID as a decimal string'}}}
averis_protocol_status
Protocol Status
Get live protocol statistics: total value locked, available liquidity, outstanding principal, utilization rate, and Hood security status.
Read only
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}}
averis_repay
Repay Obligation (Authenticated)
For OBLIGATION-mode financing positions (jobs without on-chain lien), returns the repayObligation() calldata the agent must submit after job settlement to repay principal and fee. Requires EIP-712 auth.
Input schema
{'type': 'object', 'required': ['jobId', 'agentAddress', 'nonce', 'expiry', 'signature'], 'properties': {'jobId': {'type': 'string', 'description': 'Job ID as a decimal string'}, 'nonce': {'type': 'integer', 'description': 'Monotonic nonce (get from /v2/agents/:address)'}, 'expiry': {'type': 'integer', 'description': 'Unix timestamp after which signature is invalid'}, 'signature': {'type': 'string', 'description': 'EIP-712 signature over {agentAddress, nonce, expiry, chainId}'}, 'agentAddress': {'type': 'string', 'description': 'Agent wallet address (0x...)'}}}
averis_request_funding
Request Funding (Authenticated)
Validate a funding request and return the draw() calldata for the agent to submit on-chain. This creates the controlled spending pool. REQUIRES EIP-712 authentication: include agentAddress, nonce, expiry, and signature in arguments.
Input schema
{'type': 'object', 'required': ['agentAddress', 'protocol', 'jobId', 'requestedAmount', 'nonce', 'expiry', 'signature'], 'properties': {'jobId': {'type': 'string', 'description': 'Job ID as a decimal string'}, 'nonce': {'type': 'string', 'description': 'Monotonically increasing nonce (use obligationNonces from financing contract)'}, 'expiry': {'type': 'string', 'description': 'Unix timestamp — signature validity expiry'}, 'protocol': {'type': 'string', 'description': 'Job protocol contract address'}, 'signature': {'type': 'string', 'description': 'EIP-712 signature: sign {agentAddress, nonce, expiry, chainId} over AverisProtocol v2 domain'}, 'agentAddress': {'type': 'string', 'description': 'Agent wallet address'}, 'requestedAmount': {'type': 'string', 'description': 'Requested USDC amount in raw units (6 decimals)'}}}
averis_verify_job
Verify Job Eligibility
Verify a job is eligible for Averis financing. Checks that the job exists, is funded, has not expired, the agent is the provider, and the payout receiver is set to the ReceivableRouter (lien established). Returns the maximum advance amount.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['protocol', 'jobId'], 'properties': {'jobId': {'type': 'string', 'description': 'Job ID as a decimal string'}, 'protocol': {'type': 'string', 'description': 'Job protocol contract address (use AverisACP address for native jobs)'}, 'agentAddress': {'type': 'string', 'description': 'Agent wallet address (optional — used for provider check)'}, 'requestedAmount': {'type': 'string', 'description': 'Requested USDC amount in raw units (6 decimals, optional)'}}}
get_agent_capabilities
Get declared capabilities for an agent (research, coding, payments, DeFi, etc.). Capabilities are self-declared and can reference attestation evidence.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string'}}}
get_agent_counterparties
Get counterparty graph for an agent: agents/services they have transacted with, interaction count, volume, disputes, and relationship status.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string'}}}
get_agent_credit_capacity
Get current Averis credit capacity for an agent: available credit, exposure, credit limit, risk tier, advance rate, and vault liquidity. Combines Averis Bank data with Passport identity.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string'}}}
get_agent_identity
Resolve ERC-8004 identity for an agent across all supported chains (Robinhood Chain Testnet, Arc Testnet). Returns agentId, wallet, metadataURI, and verification status per chain.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string', 'description': 'Agent wallet address (0x...)'}}}
get_agent_passport
Get the complete Agent Economic Passport for a wallet address. Returns identity, capabilities, policies, reputation evidence, risk tier, and Averis Bank integration.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string', 'description': 'Agent wallet address (0x...)'}}}
get_agent_policies
Get onchain EIP-712 policy commitments for an agent from AgentPolicyRegistry (Robinhood Chain Testnet). Includes version, expiry, revocation status, and policy hashes.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string'}}}
get_agent_receipts
Get verifiable economic receipts for an agent from AgentReceiptRegistry (onchain anchors) merged with offchain metadata. Verification states: SELF_REPORTED, AVERIS_VERIFIED, EXTERNAL_ATTESTER.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string'}}}
get_agent_reputation
Get evidence-based reputation for an agent: jobs completed/failed/disputed, payments, financing repaid, outstanding obligations, counterparties, receipts. Not a score — raw evidence.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string'}}}
get_agent_risk
Get risk profile for an agent from Averis Bank: risk tier (UNRATED/ELIGIBLE/ACTIVE/HIGH_UTILIZATION/AT_LIMIT), credit capacity, exposure, and contributing risk factors.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'agentAddress': {'type': 'string'}}}
get_agent_transactions
Get economic transaction history for an agent. Supports filtering by type, status, counterparty. Types: JOB_PAYMENT, FINANCING, CREDIT_REPAYMENT, ESCROW, REFUND, API_PURCHASE, COMPUTE_PURCHASE, AGENT_TO_AGENT, TRADING, OTHER.
Input schema
{'type': 'object', 'required': ['agentAddress'], 'properties': {'type': {'type': 'string', 'description': 'Filter by transaction type'}, 'limit': {'type': 'number', 'default': 50}, 'offset': {'type': 'number', 'default': 0}, 'status': {'type': 'string', 'description': 'Filter by status (active/completed/failed/disputed)'}, 'agentAddress': {'type': 'string'}, 'counterparty': {'type': 'string', 'description': 'Filter by counterparty address'}}}
History
Recent tool changes
Added
averis_passport_prepare_policy_commit
Oct. 1, 2026, 2:43 a.m.
Added
averis_passport_prepare_mint
Oct. 1, 2026, 2:43 a.m.
Added
averis_passport_verify_identity
Oct. 1, 2026, 2:43 a.m.
Added
get_agent_credit_capacity
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_receipts
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_counterparties
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_transactions
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_risk
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_reputation
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_policies
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_capabilities
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_identity
Sept. 29, 2026, 2:50 a.m.
Added
get_agent_passport
Sept. 29, 2026, 2:50 a.m.
Added
averis_repay
Sept. 21, 2026, 2:40 a.m.
Added
averis_position_status
Sept. 21, 2026, 2:40 a.m.
Added
averis_pool_status
Sept. 21, 2026, 2:40 a.m.
Added
averis_request_funding
Sept. 21, 2026, 2:40 a.m.
Added
averis_get_quote
Sept. 21, 2026, 2:40 a.m.
Added
averis_verify_job
Sept. 21, 2026, 2:40 a.m.
Added
averis_check_eligibility
Sept. 21, 2026, 2:40 a.m.
Added
averis_protocol_status
Sept. 21, 2026, 2:40 a.m.
Added
averis_discover
Sept. 21, 2026, 2:40 a.m.
Discover
Similar MCP servers
The Stall
ai.intuitek.the-stall/the-stall
Provides pay-per-call tools for YouTube keyword research and research on stocks, crypto, DeFi, options, and macroeconomic data.
Crank Protocol
ing.crank/crank
Provides non-custodial Solana and EVM tools for swaps, derivatives, lending, staking, tokenized equities, bridging, and strategy …
x402-services
ai.firmbrain/x402-services
Provides on-chain, trading, and AI tools for Robinhood Chain.
FortFi Treasury MCP
io.github.rebelArtists/fortfi-treasury-mcp
Provides policy-controlled crypto treasury operations across chains, including wallets, payments, token discovery, swaps, bridges…
DeltaSignal ATLAS-7
io.github.aitrailblazer/deltasignal-atlas-7
Analyzes SEC and XBRL data for crypto-related public companies, including fundamentals, issuer signals, peer comparisons, stress …
intel
io.chainhelix/intel
Provides multi-chain market intelligence, blockchain activity metrics, trading and portfolio planning, sanctions clearance, agent…
TradingCalc MCP: Options, Forex, Risk Stats, Prediction Markets, On-Chain & Crypto Futures
io.github.SKalinin909/tradingcalc
Performs deterministic calculations for crypto futures, funding, leverage, liquidation, position sizing, token swaps, on-chain ri…
Market Intelligence API
com.marketintelligenceapi.api/market-intelligence
Analyzes crypto and tokenized-asset markets using DEX flows, perpetual positioning, smart-money activity, token risk, market news…