@arcisprotocol/mcp 0.1.3 → 0.2.0

package/README.md

@@ -2,54 +2,41 @@
 
 Arcis Protocol MCP Server — connect any AI agent to DeFi vaults in one tool call.
 
-Supports **two modes**: local (stdio) for Claude Desktop/Code, and remote (HTTP) for Claude.ai custom connectors.
-
-## Install
-
-```bash
-npm install @arcisprotocol/mcp
-```
+Three deployment modes: local stdio, self-hosted HTTP, and Vercel serverless.
 
 ## Mode 1: Local (Claude Desktop / Claude Code)
 
-Add to `~/.claude/claude_desktop_config.json`:
-
 ```json
 {
   "mcpServers": {
-    "arcis": {
-      "command": "npx",
-      "args": ["@arcisprotocol/mcp"]
-    }
+    "arcis": { "command": "npx", "args": ["@arcisprotocol/mcp"] }
   }
 }
 ```
 
-## Mode 2: Remote (Claude.ai Custom Connector)
-
-Start the HTTP server:
+## Mode 2: Self-Hosted HTTP
 
 ```bash
-npx @arcisprotocol/mcp start:remote
-# or
-PORT=3001 node -e "import('@arcisprotocol/mcp/dist/remote.js')"
+PORT=3001 npx @arcisprotocol/mcp start:remote
 ```
 
-Then in Claude.ai: **Settings → Connectors → Add Custom Connector** → paste your server URL (e.g. `https://mcp.arcis.money/mcp`).
+Deploy to Railway, Render, or Fly.io for a persistent URL.
 
-### Deploy to production
+## Mode 3: Vercel Serverless (Claude.ai Custom Connector)
 
-```bash
-git clone https://github.com/Arcis-Protocol/mcp.git
-cd mcp && npm install && npm run build
-PORT=3001 node dist/remote.js
-```
+This repo deploys directly to Vercel as a Next.js app with Streamable HTTP transport.
+
+1. Import this repo at [vercel.com/new](https://vercel.com/new)
+2. Deploy — zero config needed
+3. Your MCP endpoint: `https://your-project.vercel.app/api/mcp`
+
+Then in Claude.ai: **Settings → Connectors → Add Custom Connector** → paste the URL.
 
-Use a reverse proxy (nginx, Caddy) or deploy to Railway / Render / Fly.io for a persistent URL.
+Uses `mcp-handler` — Vercel's official MCP deployment package.
 
 ## Tools
 
-### Read (no auth required)
+### Read (7 tools, no auth)
 
 | Tool | Description |
 |---|---|
@@ -59,24 +46,31 @@ Use a reverse proxy (nginx, Caddy) or deploy to Railway / Render / Fly.io for a
 | `arcis_credit_status` | Lending pool, total borrowed, utilization |
 | `arcis_credit_tiers` | ERC-8004 reputation tier table |
 | `arcis_credit_health` | Check loan health + total owed |
-| `arcis_contracts` | All 7 deployed contract addresses |
+| `arcis_contracts` | All deployed contract addresses |
 
-### Write (private key required)
+### Write (2 tools, rate-limited)
 
 | Tool | Description |
 |---|---|
-| `arcis_deposit` | Deposit USDC → raUSDC (auto-approval) |
+| `arcis_deposit` | Deposit USDC → raUSDC (auto-approval, 60s cooldown) |
 | `arcis_withdraw` | Redeem raUSDC → USDC (supports withdraw_all) |
 
-### Resources
+## Project Structure
 
-| URI | Description |
-|---|---|
-| `arcis://protocol-info` | Protocol overview, ATI spec, product descriptions |
+```
+src/
+  index.ts       → stdio entry (npx / Claude Desktop)
+  remote.ts      → HTTP entry (self-hosted, PORT env)
+  server.ts      → shared tool definitions (mcp-use)
+app/
+  api/mcp/
+    route.ts     → Vercel serverless (mcp-handler, Streamable HTTP)
+  page.tsx       → Landing page at /
+```
 
 ## Network
 
-Currently targets Base Sepolia testnet. Mainnet addresses updated after deployment.
+Base Sepolia testnet. Mainnet addresses updated after deployment.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arcisprotocol/mcp",
-  "version": "0.1.3",
-  "description": "Arcis Protocol MCP Server — connect any AI agent to DeFi vaults in one tool call",
+  "version": "0.2.0",
+  "description": "Arcis Protocol MCP Server \u2014 connect any AI agent to DeFi vaults in one tool call",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -17,9 +17,19 @@
     "dev:remote": "tsx src/remote.ts",
     "start": "node dist/index.js",
     "start:remote": "node dist/remote.js",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "dev:vercel": "next dev",
+    "build:vercel": "next build"
   },
-  "keywords": ["arcis", "mcp", "model-context-protocol", "defi", "ai-agents", "vault", "base"],
+  "keywords": [
+    "arcis",
+    "mcp",
+    "model-context-protocol",
+    "defi",
+    "ai-agents",
+    "vault",
+    "base"
+  ],
   "author": "Arcis Protocol <dev@arcis.money>",
   "license": "MIT",
   "repository": {
@@ -33,12 +43,18 @@
   "dependencies": {
     "mcp-use": "^0.14.0",
     "viem": "^2.21.0",
-    "zod": "^3.23.0"
+    "zod": "^3.23.0",
+    "mcp-handler": "^0.1.0"
   },
   "devDependencies": {
     "typescript": "^5.6.0",
     "tsup": "^8.3.0",
     "tsx": "^4.19.0",
     "@types/node": "^22.0.0"
+  },
+  "optionalDependencies": {
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
   }
-}
+}