Pingera Mcp
About
An MCP server for Pingera monitoring platform. Geo-distributed monitoring, playwright scripts execution, status pages.
Explore
- Modular Architecture: Separate Pingera API client library with clean abstractions
- Flexible Operation Modes: Run in read-only or read-write mode
- MCP Tools: Execute monitoring operations through tools (list_pages, get_page_details, test_connection)
- Robust Error Handling: Comprehensive error handling with custom exception hierarchy
- Real-time Data: Direct integration with Pingera API v1 for live monitoring data
- Type Safety: Pydantic models for data validation and serialization
- Configurable: Environment-based configuration management
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Pingera McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Python 3.10+
- UV package manager
- Pingera API key
uv sync
- PINGERA_API_KEY - Your Pingera API key (required)
- PINGERA_MODE - Operation mode: read_only (default) or read_write
- PINGERA_BASE_URL - API endpoint (default: https://api.pingera.ru/v1)
- PINGERA_TIMEOUT - Request timeout in seconds (default: 30)
- PINGERA_MAX_RETRIES - Maximum retry attempts (default: 3)
- PINGERA_DEBUG - Enable debug logging (default: false)
- PINGERA_SERVER_NAME - Server display name (default: Pingera MCP Server)
Once configured, you can ask Claude to:
- "List my monitored status pages"
- "Show details for a specific page"
- "Test the Pingera API connection"
- "Get the current monitoring status"
Run all tests:
uv run pytest
Run tests with verbose output:
uv run pytest -v
Run specific test files:
uv run pytest tests/test_models.py
uv run pytest tests/test_config.py
uv run pytest tests/test_mcp_server.py
Run tests with coverage:
uv run pytest --cov=pingera --cov=config --cov=mcp_server
```
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"pingera mcp": {
"pingera": {
"command": "uv",
"args": [
"run",
"--with",
"pingera-mcp-server",
"--python",
"3.10",
"python",
"-m",
"pingera_mcp"
],
"env": {
"PINGERA_API_KEY": "your_api_key_here",
"PINGERA_MODE": "read_only",
"PINGERA_BASE_URL": "https://api.pingera.ru/v1",
"PINGERA_TIMEOUT": "30",
"PINGERA_MAX_RETRIES": "3",
"PINGERA_DEBUG": "false",
"PINGERA_SERVER_NAME": "Pingera MCP Server"
}
}
}
}
}McpServers
{
"pingera": {
"command": "uv",
"args": [
"run",
"--with",
"pingera-mcp-server",
"--python",
"3.10",
"python",
"-m",
"pingera_mcp"
],
"env": {
"PINGERA_API_KEY": "your_api_key_here",
"PINGERA_MODE": "read_only",
"PINGERA_BASE_URL": "https://api.pingera.ru/v1",
"PINGERA_TIMEOUT": "30",
"PINGERA_MAX_RETRIES": "3",
"PINGERA_DEBUG": "false",
"PINGERA_SERVER_NAME": "Pingera MCP Server"
}
}
}A Model Context Protocol (MCP) server for the Pingera monitoring service, providing seamless integration between AI models and monitoring data.
Features
- Modular Architecture: Separate Pingera API client library with clean abstractions
- Flexible Operation Modes: Run in read-only or read-write mode
- MCP Tools: Execute monitoring operations through tools (list_pages, get_page_details, test_connection)
- Robust Error Handling: Comprehensive error handling with custom exception hierarchy
- Real-time Data: Direct integration with Pingera API v1 for live monitoring data
- Type Safety: Pydantic models for data validation and serialization
- Configurable: Environment-based configuration management
Quick Start
Prerequisites
- Python 3.10+ - UV package manager - Pingera API keyInstallation and Setup
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
