mcp-rp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-rplist the last 10 launches in project 'Alpha'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server for ReportPortal
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
Related MCP server: Xray MCP Server
Installation
pip install -r requirements.txtConfiguration
The server reads configuration from three sources (in priority order):
Environment variables (
RP_URL,RP_TOKEN,RP_PROJECT, etc.).envfile in the project rootconfig.yamlfile
Quick Start
Copy the example files and fill in your values:
cp .env.example .env
# Edit .env with your ReportPortal URL, token, and projectOr use a YAML config:
cp config.example.yaml config.yaml
# Edit config.yaml with your settingsEnvironment Variables
Variable | Description | Required |
| ReportPortal server URL | Yes |
| API token (from Profile > API Keys) | Yes* |
| Project name | Yes |
| Username (alternative to token) | No* |
| Password (alternative to token) | No* |
| Verify SSL certificates (default | 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.pyRun with a specific config file
python main.py /path/to/config.yamlCursor 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 |
| List launches with filters (status, name, mode, pagination) |
| Get launch by numeric ID |
| Get launch by UUID |
| Start a new launch |
| Finish a running launch |
| Force-finish a stuck launch |
| Update launch metadata |
| Delete a launch |
| Merge multiple launches |
| Compare launch statistics |
Test Items (11 tools)
Tool | Description |
| List test items with filters |
| Get test item by ID |
| Get test item by UUID |
| Create a suite, test, or step |
| Finish a test item with status |
| Update test item metadata |
| Delete a test item |
| Get execution history |
| Bulk-update defect types |
| Link bug-tracker tickets |
| Unlink bug-tracker tickets |
Logs (7 tools)
Tool | Description |
| List logs with filters |
| Get log by ID |
| Get log by UUID |
| Create a log entry |
| Get logs for nested steps |
| Search for similar logs |
| Delete a log entry |
Dashboards (7 tools)
Tool | Description |
| List all dashboards |
| Get dashboard with widgets |
| Create a new dashboard |
| Update dashboard metadata |
| Delete a dashboard |
| Add a widget to a dashboard |
| Remove a widget |
Widgets (5 tools)
Tool | Description |
| List all widget names |
| Get widget details |
| Create a new widget |
| Update widget configuration |
| Preview widget data |
Filters (5 tools)
Tool | Description |
| List all user filters |
| Get filter details |
| Create a new filter |
| Update a filter |
| Delete a filter |
Projects (8 tools)
Tool | Description |
| List all projects |
| Get project details |
| Get lightweight project name list |
| Create a new project |
| Update project configuration |
| Delete a project |
| Assign a user with a role |
| Remove a user |
Users (6 tools)
Tool | Description |
| Get authenticated user profile |
| Get user by login name |
| Search users by name/email |
| List API keys for a user |
| Create a new API key |
| Revoke an API key |
Integrations (8 tools)
Tool | Description |
| List global integrations |
| List project integrations |
| Get integration details |
| Create a global integration |
| Create a project integration |
| Update an integration |
| Delete an integration |
| 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 backoffDevelopment
# Install dev dependencies
pip install -r requirements.txt
# Run linting
ruff check src/
# Run tests
pytest tests/This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/mwaykole/mcp-rp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server