@ramaris/mcp-server

v0.2.0

Published

6 days ago

MCP server for Ramaris (ramaris.app) — on-chain wallet analytics and trading strategies on Base blockchain for Claude, Cursor, and AI assistants

Model Context Protocol (MCP) server for Ramaris — on-chain wallet analytics and trading strategies on Base. Gives AI assistants (Claude, Cursor, Windsurf, etc.) structured access to blockchain wallet data, strategy performance, and watchlists.

Quick Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ramaris": {
      "command": "npx",
      "args": ["-y", "@ramaris/mcp-server"],
      "env": {
        "RAMARIS_API_KEY": "rms_your_api_key"
      }
    }
  }
}

Claude Code

claude mcp add ramaris -- npx -y @ramaris/mcp-server
# Then set RAMARIS_API_KEY in your environment

Cursor / Windsurf

Add to .cursor/mcp.json or .windsurf/mcp.json in your project:

{
  "mcpServers": {
    "ramaris": {
      "command": "npx",
      "args": ["-y", "@ramaris/mcp-server"],
      "env": {
        "RAMARIS_API_KEY": "rms_your_api_key"
      }
    }
  }
}

Remote (HTTP) — no install required

Connect directly via Streamable HTTP transport:

URL: https://api.ramaris.app/mcp
Authorization: Bearer rms_your_api_key

Get an API Key

Sign up at ramaris.app
Go to API Access
Create a new API key

Free tier gets 1 API key with strategies:read scope (100 req/hr). Strategy tools work immediately. Upgrade to PRO for wallet tools.

Available Tools

Strategy Tools (FREE tier)

| Tool | Description | |------|-------------| | ramaris_list_strategies | List trading strategies sorted by last activity | | ramaris_get_strategy | Get detailed info about a specific strategy | | ramaris_my_watchlist | List strategies you are following |

Wallet Tools (PRO+)

| Tool | Description | |------|-------------| | ramaris_list_wallets | List tracked wallets with optional filters for activity, token quality, and risk level | | ramaris_get_wallet | Get detailed wallet info including top tokens |

Wallet Filters

ramaris_list_wallets accepts a computed array parameter with these filter values:

Activity (OR): activeDay, activeWeek, stale
Token Quality (AND): hideMemeOnly — excludes wallets trading only risky/not-recommended tokens
Risk (AND): riskConservative, riskBalanced, riskHighRisk, riskDegen

User Tools (PRO+)

| Tool | Description | |------|-------------| | ramaris_my_profile | Get your profile info | | ramaris_my_subscription | Get your subscription details |

Example Prompts

Once connected, try asking your AI assistant:

"List the top 5 strategies on Ramaris"
"Show me details for strategy abc123def"
"What strategies am I following?"
"Find the most profitable wallets" (PRO+)

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | RAMARIS_API_KEY | Yes | Your Ramaris API key (rms_...) | | RAMARIS_API_URL | No | Override API base URL (default: https://www.ramaris.app/api/v1) |

Rate Limits

| Tier | Requests/Hour | Available Tools | |------|---------------|-----------------| | FREE | 100 | Strategy tools | | PRO | 1,000 | All tools | | ULTRA | 10,000 | All tools | | ENTERPRISE | 100,000 | All tools |

License

MIT