Getting Started

Monitor your MCP servers in under 5 minutes. Track uptime, response times, and reliability scores automatically.

What is MCPulse? MCPulse is a crowdsourced reliability platform for MCP servers. Install our monitoring package, and you'll get real-time uptime tracking + contribute to the community reliability index.

1

Sign Up & Register Your Server

Create a free MCPulse account and register your MCP server to get an API key.

  1. Go to stacks.polsia.app/signup
  2. Create an account with your email
  3. Navigate to Dashboard → Register Server
  4. Enter your server name (e.g., "my-weather-server")
  5. Copy your API key — you'll need this in Step 2

Expected Output:

✓ Server registered: my-weather-server
API Key: mcpulse_sk_abc123xyz...
2

Install mcpulse-monitor

Add the monitoring package to your MCP server project.

npm install mcpulse-monitor

Zero dependencies. Works with any Node.js MCP server.

3

Add Monitoring to Your Server

Wrap your MCP server with MCPulse monitoring. Three lines of code.

const MCPulseMonitor = require('mcpulse-monitor');

// Initialize monitor
const monitor = new MCPulseMonitor({
  apiKey: process.env.MCPULSE_API_KEY,
  serverId: 'my-weather-server'  // Optional
});

// Wrap your MCP server
monitor.wrap(yourMCPServer);

// Start monitoring
monitor.start();

Add your API key to .env:

MCPULSE_API_KEY=mcpulse_sk_abc123xyz...
4

See Your Data Live

Start your MCP server and watch real-time metrics appear in the dashboard.

node your-server.js

Within 60 seconds, you'll see:

Uptime 99.8%
Avg Response Time 124ms
Error Rate 0.4%
Reliability Score A+ (95/100)

Open Dashboard →

What Gets Tracked?

📊 Metrics

  • • Total requests & success rate
  • • Average/min/max response times
  • • Error rate by error type
  • • Requests by tool name

💓 Health

  • • Uptime percentage (24h/7d/30d)
  • • Heartbeat status (every 60s)
  • • Downtime incidents
  • • Reliability score (0-100)

Next Steps

Need Help?

Stuck on setup? Have questions about MCPulse?