Skip to main content
Glama

@arcisprotocol/mcp

Arcis Protocol MCP Server — connect any AI agent to DeFi vaults in one tool call.

Three deployment modes. 9 tools. Rate-limited writes.

Mode 1: Local (Claude Desktop / Claude Code)

{
  "mcpServers": {
    "arcis": { "command": "npx", "args": ["@arcisprotocol/mcp"] }
  }
}

Related MCP server: Universal Crypto MCP

Mode 2: Self-Hosted HTTP

PORT=3001 npx @arcisprotocol/mcp start:remote

Deploy to Railway, Render, or any VPS.

Mode 3: Vercel Serverless (Claude.ai Custom Connector)

  1. Import this repo at vercel.com/new

  2. Deploy — zero config

  3. Your MCP endpoint: https://your-project.vercel.app/api/mcp

Then in Claude.ai: Settings → Connectors → Add → paste the URL.

Tools

Read (7 tools)

Tool

Description

arcis_vault_status

TVL, exchange rate, supply, capacity, reserve/deployed

arcis_vault_balance

Agent position: shares, value, USDC wallet

arcis_preview_deposit

Preview shares for a deposit amount

arcis_credit_status

Lending pool, total borrowed, utilization

arcis_credit_tiers

ERC-8004 reputation tier table

arcis_credit_health

Loan health + total owed

arcis_contracts

All deployed contract addresses

Write (2 tools, 60s rate limit)

Tool

Description

arcis_deposit

Deposit USDC → raUSDC (auto-approval)

arcis_withdraw

Redeem raUSDC → USDC (supports withdraw_all)

How It Connects

AI Agent ←→ MCP Server ←→ Base Mainnet ←→ Arcis Contracts

CUSTOS (the Arcis keeper agent) uses the same contract interfaces. If CUSTOS can operate the protocol autonomously, any agent can.

Repo

Description

core

Smart contracts — 17 contracts, 116 tests

sdk

@arcisprotocol/sdk

integrations

Framework & runtime integrations (npm + PyPI)

custos

CUSTOS — autonomous keeper agent

docs

ATI v1.1, integration guide, demo scripts

Any of the framework packages in integrations can talk to this server, and any MCP client can connect directly at https://mcp.arcis.money/mcp.


ARCIS · @arcisprotocol/mcp · MMXXVI

Available Tools

7 tools
arcis_contractsB

Get deployed contract addresses

Inputs: no named parameters.

arcis_credit_healthC

Check loan health

Inputs: loan_id (required).

arcis_credit_statusB

Get lending pool status

Inputs: no named parameters.

arcis_credit_tiersA

Get ERC-8004 reputation tiers

Inputs: no named parameters.

arcis_preview_depositC

Preview shares for deposit

Inputs: amount (required).

arcis_vault_balanceC

Check agent vault position

Inputs: agent_address (required).

arcis_vault_statusB

Get vault TVL, exchange rate, supply, capacity, reserve/deployed

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: contracts for addresses, credit health/status/tiers for different credit aspects, preview deposit for share preview, vault balance/status for vault state. No two tools overlap in functionality.

    Naming Consistency4/5

    All tools share the 'arcis_' prefix and use snake_case with a consistent area (contracts, credit, vault) followed by a property or action. However, 'arcis_contracts' differs by having only one segment, while others have two, causing slight inconsistency.

    Tool Count5/5

    With 7 tools, the server is well-scoped for a DeFi inspection interface. The count is appropriate for covering key read operations without being overwhelming.

    Completeness2/5

    The tool set is heavily read-only, missing critical write operations like deposit, withdraw, borrow, or liquidate. Agents can inspect state but cannot execute transactions, leaving significant gaps for the apparent domain.

    Related MCP Connectors

    Related MCP Servers