@ramaris/mcp-server

@ramaris/mcp-server

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

Links

• Ramaris — Base blockchain wallet analytics platform
• API Documentation
• @ramaris/sdk — Underlying TypeScript SDK
• Smithery — Smithery registry listing
• Pricing

License

MIT