🌀 On-Chain Agent Vault: Stdio MCP Server Adapter

A lightweight, 100% dependency-free standard Stdio MCP (Model Context Protocol) server adapter for the On-Chain Agent Vault.

This package enables any standard MCP client—including Claude Desktop, Cursor, or Claude Code—to instantly consume secure, crypto-gated cloud services via standard stdio JSON-RPC.

⚡ Quick Start

You don't need to manually clone or compile anything. You can hook your LLM client up to the vault directly using npx.

1. Get Your Key

Connect your Web3 wallet and generate an API key via the On-Chain Agent Vault Developer Portal. Ensure you top up your balance with a few cents of USDC on Base L2!

2. Configure Your Client

Add the following configuration block to your MCP host settings.

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%/Claude/claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "onchain-agent-vault": {
      "command": "npx",
      "args": ["-y", "onchain-agent-vault"],
      "env": {
        "AGENT_VAULT_URL": "https://vault.yourdomain.com",
        "AGENT_VAULT_KEY": "oc_vault_live_your_api_key_here"
      }
    }
  }
}

For Cursor:

1. Open Cursor Settings and navigate to Features -> MCP.
2. Click + Add New MCP Server.
3. Configure the following:
   • Name: onchain-agent-vault
   • Type: command
   • Command: env AGENT_VAULT_URL="https://vault.yourdomain.com" AGENT_VAULT_KEY="oc_vault_live_your_api_key_here" npx -y onchain-agent-vault

🛠️ Exposed Tools & Services

Once connected, your LLM gains access to the following 5 high-yield services:

1. coin-prices: Real-time cryptocurrency spot prices from Coinbase's public feeds.
2. prompt-booster: High-density engineering prompt optimizer for Claude, GPT, and Llama.
3. web-fetcher: Clean, tag-stripped on-demand webpage scraper.
4. web-search: Zero-subscription DuckDuckGo public search parser.
5. kv-store: Cloud key-value memory store to let agents persist state across independent runs.

🛡️ Micro-Billing & Balance Depletion

Each API call costs exactly $0.001 USDC on Base L2, deducted directly from your ledger balance.

If your balance runs out, the adapter returns a clean payment direction message directly inside the chat interface:

🚨 [402 Payment Required] Your On-Chain Agent Vault balance is empty!
📥 To top up, send Base USDC to your secure deposit address:
   👉 0xYourUniqueDepositAddress 👈

Simply send USDC on Base to the address provided, and you can instantly resume your agent operations without restarting your client!

⚙️ Direct Global Installation (Optional)

If you prefer to avoid npx cold-starts, you can install the adapter globally:

npm install -g onchain-agent-vault

Then configure your claude_desktop_config.json with the global executable path:

{
  "mcpServers": {
    "onchain-agent-vault": {
      "command": "onchain-agent-vault",
      "env": {
        "AGENT_VAULT_URL": "https://vault.yourdomain.com",
        "AGENT_VAULT_KEY": "oc_vault_live_your_api_key_here"
      }
    }
  }
}

📄 License

MIT License. Fully autonomous, zero middleman, $0 overhead.