Quick Start Guide¶

Setup¶

🌐 Try the Live Server (No Installation Required)¶

MCP Endpoint: https://rmcp-server-394229601724.us-central1.run.app/mcp (bearer token required) Health Check: https://rmcp-server-394229601724.us-central1.run.app/health

🖥️ Or Install Locally¶

pip install rmcp
rmcp start

That’s it! RMCP is now ready to handle statistical analysis requests via Claude Desktop, Claude web, or any MCP client.

🎯 Working examples → | 🔧 Troubleshooting →

What Can RMCP Do?¶

📊 Regression & Economics¶

Linear regression, logistic models, panel data, instrumental variables → “Analyze ROI of marketing spend”

⏰ Time Series & Forecasting¶

ARIMA models, decomposition, stationarity testing → “Forecast next quarter’s sales”

🧠 Machine Learning¶

Clustering, decision trees, random forests → “Segment customers by behavior”

📈 Statistical Testing¶

T-tests, ANOVA, chi-square, normality tests → “Is my A/B test significant?”

📋 Data Analysis¶

Descriptive stats, outlier detection, correlation analysis → “Summarize this dataset”

🔄 Data Transformation¶

Standardization, winsorization, lag/lead variables → “Prepare data for modeling”

📊 Professional Visualizations¶

Inline plots in Claude: scatter plots, histograms, heatmaps → “Show me a correlation matrix”

📁 Smart File Operations¶

CSV, Excel, JSON import with validation → “Load and analyze my sales data”

🤖 Natural Language Features¶

Formula building, error recovery, example datasets → “Help me build a regression formula”

👉 See working examples →

📊 Real Usage with Claude¶

Business Analysis¶

You: “I have sales data and marketing spend. Can you analyze the ROI?”

Claude: “I’ll run a regression analysis to measure marketing effectiveness…”

Result: “Every \(1 spent on marketing generates \)4.70 in sales. The relationship is highly significant (p < 0.001) with R² = 0.979”

Economic Research¶

You: “Test if GDP growth and unemployment follow Okun’s Law using my country data”

Claude: “I’ll analyze the correlation between GDP growth and unemployment…”

Result: “Strong support for Okun’s Law: correlation r = -0.944. Higher GDP growth significantly reduces unemployment.”

Customer Analytics¶

You: “Predict customer churn using tenure and monthly charges”

Claude: “I’ll build a logistic regression model for churn prediction…”

Result: “Model achieves 100% accuracy. Each additional month of tenure reduces churn risk by 11.3%. Higher charges increase churn risk by 3% per dollar.”

📦 Installation¶

Prerequisites¶

Python 3.11+
R 4.4.0+ with comprehensive package ecosystem: RMCP uses a systematic 429-package whitelist from CRAN task views organized into 19+ categories:

# Core packages (install these first)
install.packages(c(
  "jsonlite", "dplyr", "ggplot2", "broom", "plm", "forecast",
  "randomForest", "rpart", "caret", "AER", "vars", "mgcv"
))

# Full ecosystem automatically available: Machine Learning (61 packages),
# Econometrics (55 packages), Time Series (57 packages),
# Bayesian Analysis (40 packages), and more

Package Selection: Evidence-based, using CRAN task views and download statistics

Install RMCP¶

# Standard installation
pip install rmcp

# The Streamable HTTP transport ships in the base install.
# This extra adds pandas/openpyxl for Excel data handling.
pip install rmcp[http]

# Development installation
git clone https://github.com/finite-sample/rmcp.git
cd rmcp
pip install -e ".[dev]"

Claude Desktop Integration¶

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "rmcp": {
      "command": "rmcp",
      "args": ["start"]
    }
  }
}

HTTP Server Integration (Claude Web)¶

RMCP serves the MCP Streamable HTTP transport at /mcp (spec 2025-11-25), compatible with Claude custom connectors and OpenAI’s Responses API / ChatGPT remote MCP support. Remote deployments require a bearer token.

Production Server:

Server URL: https://rmcp-server-394229601724.us-central1.run.app/mcp

Test the connection:

# Health check
curl https://rmcp-server-394229601724.us-central1.run.app/health

# Initialize MCP session (Streamable HTTP)
curl -X POST https://rmcp-server-394229601724.us-central1.run.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer $RMCP_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0"}}}'

Local HTTP server:

# Localhost (no auth required)
rmcp serve-http

# Remote bind requires a bearer token (or --allow-unauthenticated)
RMCP_API_KEY=your-secret rmcp serve-http --host 0.0.0.0 --port 8080

Command Line Usage¶

# Start MCP server (for Claude Desktop)
rmcp start

# Start HTTP server (for web apps)
rmcp serve-http --host 0.0.0.0 --port 8080

# Start HTTPS server (production ready)
rmcp serve-http --ssl-keyfile server.key --ssl-certfile server.crt --port 8443

# Quick HTTPS setup for development
./scripts/setup/setup_https_dev.sh && source certs/https-env.sh && rmcp serve-http

# Use configuration file
rmcp --config ~/.rmcp/config.json start

# Enable debug mode
rmcp --debug start

# Check installation
rmcp --version

Shell Completion¶

# zsh — add to ~/.zshrc
eval "$(_RMCP_COMPLETE=zsh_source rmcp)"

# bash — add to ~/.bashrc (requires bash 4.4+)
eval "$(_RMCP_COMPLETE=bash_source rmcp)"

# fish — write to the completions directory
_RMCP_COMPLETE=fish_source rmcp > ~/.config/fish/completions/rmcp.fish

macOS ships bash 3.2, which is too old — click prints a warning and completion does nothing. Use zsh (the macOS default) or install a newer bash.

Working Examples¶

See detailed working examples in the examples folder: