@ramaris/mcp-server

@ramaris/mcp-server

Model Context Protocol (MCP) server for Ramaris. Gives AI assistants (Claude, Cursor, etc.) access to on-chain wallet analytics and trading strategies on Base.

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

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

{
  "mcpServers": {
    "ramaris": {
      "command": "npx",
      "args": ["-y", "@ramaris/mcp-server"],
      "env": {
        "RAMARIS_API_KEY": "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 sorted by realized PnL
ramaris_get_wallet	Get detailed wallet info including top tokens

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
• @ramaris/sdk - Underlying TypeScript SDK
• API Documentation
• Pricing

License

MIT