@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

License

MIT

mcp-server

Quick Install