Getting Started

This guide walks you through connecting your AI assistant to Statly's MCP server.

Server URL

https://mcp.statly.live/mcp

The server uses Streamable HTTP Transport, the modern MCP transport protocol that works over standard HTTP.

Client Configuration

Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "statly": {
      "url": "https://mcp.statly.live/mcp",
      "transport": "streamable-http"
    }
  }
}

With API key authentication:

{
  "mcpServers": {
    "statly": {
      "url": "https://mcp.statly.live/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer sk_live_your_api_key"
      }
    }
  }
}

Restart Claude Desktop after saving.

Verify Connection

Once configured, test the connection by asking your AI:

"Search the Statly docs for monitor configuration"

You should see results from our documentation.

Public vs Authenticated Access

Without Authentication (Public)

You can use documentation tools immediately without any API key:

search_docs - Search Statly documentation
get_sdk_reference - Get SDK API references
get_code_example - Find code examples
get_api_reference - View REST API documentation

Rate limit: 100 requests per minute per IP.

With Authentication

To access your organization's data (monitors, incidents, etc.), you need an API key:

Create an API Key

Go to Dashboard → Settings → API Keys (opens in a new tab)
Click Create API Key
Choose your permission scope:
- Full Access: Read and write all resources
- Read Only: View data but can't modify
- Custom: Fine-grained per-resource permissions

Add to Configuration

Add the Authorization header to your MCP client configuration:

{
  "headers": {
    "Authorization": "Bearer sk_live_your_api_key"
  }
}

Verify Access

Ask your AI:

"List my monitors"

You should see your organization's monitors.

Device Authorization Flow

For interactive setup without manually copying API keys, Statly supports the OAuth Device Authorization Flow:

Start Authorization

Your AI client requests a device code from /auth/device.

Enter Code

Visit statly.live/mcp/authorize (opens in a new tab) and enter the displayed code.

Select Permissions

Choose which organization and permission scopes to grant.

Complete

The AI client automatically receives authorization and can access your data.

Device Authorization Flow is ideal for AI clients that support it. Check your client's documentation for compatibility.

Example Prompts

Once connected, try these prompts:

Documentation

"Search Statly docs for Express error handling"
"Show me the Python SDK installation guide"
"What notification channels does Statly support?"

Monitors (requires auth)

"List all my monitors and their current status"
"Create an HTTP monitor for api.example.com"
"Pause the production-api monitor"

Incidents (requires auth)

"Create an incident: Database is experiencing high latency"
"Update the current incident: We've identified the root cause"
"Resolve all open incidents"

Status (requires auth)

"What's the current status of my services?"
"Show me the uptime for the past 24 hours"
"Are there any ongoing incidents?"

Troubleshooting

"Authentication required" error

You're trying to access organization data without an API key. Add your API key to the configuration.

"Rate limit exceeded"

Public endpoints are limited to 100 requests/minute. Wait and try again, or authenticate for higher limits.

"Organization not found"

The API key may be invalid or expired. Generate a new one from the dashboard.

Client won't connect

Verify the URL is exactly https://mcp.statly.live/mcp
Ensure transport is set to streamable-http (not sse or stdio)
Check your client supports remote MCP servers
Restart your AI client after configuration changes

Overview Authentication