Rp

An MCP (Model Context Protocol) server that exposes ReportPortal API operations as tools for AI assistants. Covers launches, test items, logs, dashboards, widgets, filters, projects, users, and integrations.

Prerequisites

• Python 3.11+
• A running ReportPortal instance (5.x)
• An API token or username/password credentials

Installation

pip install -r requirements.txt

Configuration

The server reads configuration from three sources (in priority order):

1. Environment variables (RP_URL, RP_TOKEN, RP_PROJECT, etc.)
2. .env file in the project root
3. config.yaml file

Quick Start

Copy the example files and fill in your values:

cp .env.example .env
# Edit .env with your ReportPortal URL, token, and project

Or use a YAML config:

cp config.example.yaml config.yaml
# Edit config.yaml with your settings

Environment Variables

Variable	Description	Required
RP_URL	ReportPortal server URL	Yes
RP_TOKEN	API token (from Profile > API Keys)	Yes*
RP_PROJECT	Project name	Yes
RP_USERNAME	Username (alternative to token)	No*
RP_PASSWORD	Password (alternative to token)	No*
RP_VERIFY_SSL	Verify SSL certificates (default true)	No

* Either RP_TOKEN or both RP_USERNAME and RP_PASSWORD are required.

Usage

Run with stdio transport (for Cursor, Claude Desktop, etc.)

python main.py

Run with a specific config file

python main.py /path/to/config.yaml

Cursor MCP Configuration

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "reportportal": {
      "command": "python",
      "args": ["/path/to/mcp-rp/main.py"],
      "env": {
        "RP_URL": "https://reportportal.example.com",
        "RP_TOKEN": "your-api-token",
        "RP_PROJECT": "my_project"
      }
    }
  }
}

Available Tools

Launches (10 tools)

Tool	Description
rp_list_launches	List launches with filters (status, name, mode, pagination)
rp_get_launch	Get launch by numeric ID
rp_get_launch_by_uuid	Get launch by UUID
rp_create_launch	Start a new launch
rp_finish_launch	Finish a running launch
rp_force_finish_launch	Force-finish a stuck launch
rp_update_launch	Update launch metadata
rp_delete_launch	Delete a launch
rp_merge_launches	Merge multiple launches
rp_compare_launches	Compare launch statistics

Test Items (11 tools)

Tool	Description
rp_list_test_items	List test items with filters
rp_get_test_item	Get test item by ID
rp_get_test_item_by_uuid	Get test item by UUID
rp_create_test_item	Create a suite, test, or step
rp_finish_test_item	Finish a test item with status
rp_update_test_item	Update test item metadata
rp_delete_test_item	Delete a test item
rp_get_test_item_history	Get execution history
rp_update_test_item_issues	Bulk-update defect types
rp_link_external_issue	Link bug-tracker tickets
rp_unlink_external_issue	Unlink bug-tracker tickets

Logs (7 tools)

Tool	Description
rp_list_logs	List logs with filters
rp_get_log	Get log by ID
rp_get_log_by_uuid	Get log by UUID
rp_create_log	Create a log entry
rp_get_nested_step_logs	Get logs for nested steps
rp_search_logs	Search for similar logs
rp_delete_log	Delete a log entry

Dashboards (7 tools)

Tool	Description
rp_list_dashboards	List all dashboards
rp_get_dashboard	Get dashboard with widgets
rp_create_dashboard	Create a new dashboard
rp_update_dashboard	Update dashboard metadata
rp_delete_dashboard	Delete a dashboard
rp_add_widget_to_dashboard	Add a widget to a dashboard
rp_remove_widget_from_dashboard	Remove a widget

Widgets (5 tools)

Tool	Description
rp_list_widget_names	List all widget names
rp_get_widget	Get widget details
rp_create_widget	Create a new widget
rp_update_widget	Update widget configuration
rp_preview_widget	Preview widget data

Filters (5 tools)

Tool	Description
rp_list_filters	List all user filters
rp_get_filter	Get filter details
rp_create_filter	Create a new filter
rp_update_filter	Update a filter
rp_delete_filter	Delete a filter

Projects (8 tools)

Tool	Description
rp_list_projects	List all projects
rp_get_project	Get project details
rp_get_project_names	Get lightweight project name list
rp_create_project	Create a new project
rp_update_project	Update project configuration
rp_delete_project	Delete a project
rp_assign_user_to_project	Assign a user with a role
rp_unassign_user_from_project	Remove a user

Users (6 tools)

Tool	Description
rp_get_current_user	Get authenticated user profile
rp_get_user	Get user by login name
rp_search_users	Search users by name/email
rp_list_api_keys	List API keys for a user
rp_create_api_key	Create a new API key
rp_delete_api_key	Revoke an API key

Integrations (8 tools)

Tool	Description
rp_list_global_integrations	List global integrations
rp_list_project_integrations	List project integrations
rp_get_integration	Get integration details
rp_create_global_integration	Create a global integration
rp_create_project_integration	Create a project integration
rp_update_integration	Update an integration
rp_delete_integration	Delete an integration
rp_test_integration_connection	Test integration connectivity

Architecture

main.py                  FastMCP server entry point
src/
  config/settings.py     Pydantic settings, YAML + env var loading
  clients/
    base.py              Abstract HTTP client interface
    reportportal.py      aiohttp client with OAuth, retries, rate limiting
  models/                Pydantic models for all RP entities
  services/              One service per domain (launch, test_item, log, ...)
  tools/                 MCP tool registrations per domain
  utils/
    logging.py           Structured logging (structlog)
    retry.py             Async retry with exponential backoff

Development

# Install dev dependencies
pip install -r requirements.txt

# Run linting
ruff check src/

# Run tests
pytest tests/