Click on "Deploy 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-rp list 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.
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.
Python 3.11+
A running ReportPortal instance (5.x)
An API token or username/password credentials
Related MCP server: Xray MCP Server
pip install -r requirements.txtThe server reads configuration from three sources (in priority order):
Environment variables (RP_URL, RP_TOKEN, RP_PROJECT, etc.)
.env file in the project root
config.yaml file
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 settingsVariable | 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.
python main.pypython main.py /path/to/config.yamlAdd 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"
}
}
}
}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 |
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 |
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 |
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 |
Tool | Description |
| List all widget names |
| Get widget details |
| Create a new widget |
| Update widget configuration |
| Preview widget data |
Tool | Description |
| List all user filters |
| Get filter details |
| Create a new filter |
| Update a filter |
| Delete a filter |
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 |
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 |
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 |
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# Install dev dependencies
pip install -r requirements.txt
# Run linting
ruff check src/
# Run tests
pytest tests/This server cannot be deployed
Direct access to Cypress tests results and accessibility reports in your AI workflow.
Drive OctoPerf load testing from any AI agent: import, edit, validate, run scenarios, read metrics.
Give your AI agents the tools to build, manage, and run automation workflows.
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
