Scoring Engine MCP Server
OfficialClick 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., "@Scoring Engine MCP Server show me the current scoreboard"
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.
Scoring Engine MCP Server
An MCP (Model Context Protocol) server for Scoring Engine - an open-source platform for running Red/White/Blue team cybersecurity competitions.
Features
This MCP server provides programmatic access to all Scoring Engine API functionality:
Scoreboard
Get bar chart data (team scores)
Get line chart data (score progression over rounds)
Overview
Get current round data
Get overview status for all teams and services
Get column headers
Get detailed competition data
Team Management
Get team statistics (placement, score)
Get team services with status and check history
Get current service status
Service Management
Get check history for services
Update service account credentials (blue team)
Update service host/port (blue team)
Statistics
Get round statistics with up/down counts
Flags (Red/White team)
Get active flags
Get flag solve status
Get flag scoring totals
Injects
List team injects
Get inject details
Submit injects
View/add comments
List inject files
Notifications
List all notifications
Get unread notifications
Admin (White team only)
Team/user management
Engine control (pause/resume)
Service configuration
Inject template management
Scoring and grading
Settings management
Related MCP server: htb-app-mcp
Installation
npm install
npm run buildConfiguration
Set the following environment variables:
Variable | Description | Default |
| Base URL of your Scoring Engine instance |
|
| Session cookie value for authentication | (empty) |
Getting the Session Cookie
Log in to your Scoring Engine instance in a web browser
Open Developer Tools (F12)
Go to Application > Cookies
Copy the value of the
sessioncookie
Usage with Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"scoringengine": {
"command": "node",
"args": ["/path/to/scoringengine-mcp/dist/index.js"],
"env": {
"SCORING_ENGINE_URL": "https://your-scoring-engine.example.com",
"SCORING_ENGINE_SESSION": "your-session-cookie-value"
}
}
}
}Usage with Claude Code
Add to your Claude Code MCP settings:
{
"mcpServers": {
"scoringengine": {
"command": "node",
"args": ["/path/to/scoringengine-mcp/dist/index.js"],
"env": {
"SCORING_ENGINE_URL": "https://your-scoring-engine.example.com",
"SCORING_ENGINE_SESSION": "your-session-cookie-value"
}
}
}
}Available Tools
Scoreboard Tools
scoreboard_get_bar_data- Get team bar chart datascoreboard_get_line_data- Get team line chart data
Overview Tools
overview_get_round_data- Get current round infooverview_get_data- Get team/service overviewoverview_get_columns- Get column headersoverview_get_detailed_data- Get detailed data for display
Team Tools
team_get_stats- Get team placement and scoreteam_get_services- Get team's services with detailsteam_get_services_status- Get current service status
Service Tools
service_get_checks- Get check historyservice_update_account- Update account credentialsservice_update_host- Update service hostnameservice_update_port- Update service port
Stats Tools
stats_get_rounds- Get round statistics
Flags Tools (Red/White team)
flags_get_active- Get active flagsflags_get_solves- Get solve statusflags_get_totals- Get scoring totals
Injects Tools
injects_list- List team injectsinject_get- Get inject detailsinject_submit- Submit an injectinject_get_comments- Get inject commentsinject_add_comment- Add a commentinject_get_files- List inject files
Notifications Tools
notifications_list- List all notificationsnotifications_unread- Get unread notifications
Admin Tools (White team only)
admin_get_teams- List all teamsadmin_add_user- Create useradmin_add_team- Create teamadmin_update_password- Change user passwordadmin_toggle_engine- Pause/resume engineadmin_get_engine_status- Check if pausedadmin_get_engine_stats- Get engine statisticsadmin_get_worker_stats- Get worker statsadmin_get_queue_stats- Get queue statsadmin_get_round_progress- Get round progressadmin_update_check- Modify check resultsadmin_update_host- Change service hostadmin_update_port- Change service portadmin_update_points- Update point valuesadmin_update_worker_queue- Assign worker queueadmin_update_target_round_time- Set round durationadmin_update_worker_refresh_time- Set refresh intervaladmin_injects_get_templates- List inject templatesadmin_injects_get_template- Get template detailsadmin_injects_create_template- Create templateadmin_injects_update_template- Update templateadmin_injects_delete_template- Delete templateadmin_inject_grade- Grade an injectadmin_injects_get_scores- Get inject scoresadmin_injects_get_bar_chart- Get inject chart dataadmin_update_setting- Update settingsadmin_update_environment_info- Update environmentadmin_update_property- Update properties
Development
# Install dependencies
npm install
# Build
npm run build
# Watch mode
npm run watch
# Run directly with ts-node
npm run devLicense
MIT
Available Tools
53 toolsadmin_add_teamA
Create a new team. White team only.
Inputs: name (required), color (required).
admin_add_userA
Create a new user account. White team only.
Inputs: team_id (required), password (required), username (required).
admin_get_engine_statsA
Get engine statistics including round number and check counts. White team only.
Inputs: no named parameters.
admin_get_engine_statusA
Get whether the scoring engine is paused. White team only.
Inputs: no named parameters.
admin_get_queue_statsB
Get Celery queue statistics. White team only.
Inputs: no named parameters.
admin_get_round_progressA
Get task completion percentages per team for current round. White team only.
Inputs: no named parameters.
admin_get_teamsA
Get all teams with associated users and credentials. White team only.
Inputs: no named parameters.
admin_get_worker_statsA
Get Celery worker statistics. White team only.
Inputs: no named parameters.
admin_inject_gradeB
Record inject grade and timestamp. White team only.
Inputs: score (required), inject_id (required).
admin_injects_create_templateB
Create a new inject template. White team only.
Inputs: title (required), content (required), max_score (required).
admin_injects_delete_templateB
Delete an inject template. White team only.
Inputs: template_id (required).
admin_injects_get_bar_chartA
Get summed inject scores per blue team. White team only.
Inputs: no named parameters.
admin_injects_get_scoresA
Get inject scores organized by template and team. White team only.
Inputs: no named parameters.
admin_injects_get_templateA
Get specific inject template details. White team only.
Inputs: template_id (required).
admin_injects_get_templatesA
Get all inject templates with team assignments. White team only.
Inputs: no named parameters.
admin_injects_update_templateB
Update inject template properties. White team only.
Inputs: template_id (required), title, content, max_score.
admin_toggle_engineA
Pause or resume the scoring engine. White team only.
Inputs: no named parameters.
admin_update_checkA
Modify check results and reasons. White team only.
Inputs: reason (required), result (required), check_id (required).
admin_update_environment_infoB
Update environment matching content. White team only.
Inputs: environment_id (required), matching_content (required).
admin_update_hostC
Change service hostname. White team only.
Inputs: host (required), service_id (required).
admin_update_passwordA
Change a user's password. White team only.
Inputs: user_id (required), password (required).
admin_update_pointsA
Update service point values. White team only.
Inputs: points (required), service_id (required).
admin_update_portC
Change service port. White team only.
Inputs: port (required), service_id (required).
admin_update_propertyB
Modify property name/value pairs. White team only.
Inputs: name (required), value (required), property_id (required).
admin_update_settingB
Update various settings like blue team permissions, about page content, etc. White team only.
Inputs: value (required), setting (required).
admin_update_target_round_timeB
Set round duration. White team only.
Inputs: time (required).
admin_update_worker_queueA
Assign worker queue to service. White team only.
Inputs: service_id (required), worker_queue (required).
admin_update_worker_refresh_timeB
Configure worker refresh intervals. White team only.
Inputs: time (required).
flags_get_activeA
Get all active flags including type, platform, permissions, path, and content. Requires red or white team membership.
Inputs: no named parameters.
flags_get_solvesA
Get flag solve status showing user and root level solves per team/service. Requires red or white team membership.
Inputs: no named parameters.
flags_get_totalsA
Get flag scoring totals per team including Windows score, NIX score, and combined total. Requires red or white team membership.
Inputs: no named parameters.
inject_add_commentB
Add a comment to an inject.
Inputs: comment (required), inject_id (required).
inject_getB
Get detailed inject information including score, status, comments, and files.
Inputs: inject_id (required).
inject_get_commentsA
Get all comments for an inject.
Inputs: inject_id (required).
inject_get_filesB
Get list of files attached to an inject.
Inputs: inject_id (required).
injects_listA
List all injects for the current user's team including id, title, score, max_score, status, and times.
Inputs: no named parameters.
inject_submitA
Submit an inject, marking it as submitted with timestamp.
Inputs: inject_id (required).
notifications_listA
Get all notifications for the current user's team including read status.
Inputs: no named parameters.
notifications_unreadA
Get unread notifications for the current user's team.
Inputs: no named parameters.
overview_get_columnsA
Get column headers for the overview including blue team names.
Inputs: no named parameters.
overview_get_dataA
Get overview data mapping team names to services with host, port, and passing status.
Inputs: no named parameters.
overview_get_detailed_dataB
Get detailed overview data including current scores, team rankings, service up/down ratios, and per-service status.
Inputs: no named parameters.
overview_get_round_dataA
Get current round number and start time of the competition.
Inputs: no named parameters.
scoreboard_get_bar_dataA
Get team bar chart data including labels and scores. Returns team names, service scores, and inject scores for visualization.
Inputs: no named parameters.
scoreboard_get_line_dataA
Get team line chart data showing score progression over rounds. Returns round labels and cumulative scores per team with colors.
Inputs: no named parameters.
service_get_checksA
Get check history for a service including round number, result, timestamp, reason, output, and command.
Inputs: service_id (required).
service_update_accountA
Update username or password for a service account. Requires blue team edit permissions.
Inputs: account_id (required), password, username.
service_update_hostA
Update hostname for a service. Requires blue team edit permissions.
Inputs: host (required), service_id (required).
service_update_portB
Update port for a service. Requires blue team edit permissions.
Inputs: port (required), service_id (required).
stats_get_roundsA
Get round statistics including start/end times, duration, and up/down service counts. Blue team sees only their stats, white team sees all.
Inputs: no named parameters.
team_get_servicesA
Get all services for a team with details including host, port, status, ranking, scores, and last ten check results.
Inputs: team_id (required).
team_get_services_statusA
Get current service status for a team mapping service names to their check results for the most recent round.
Inputs: team_id (required).
team_get_statsA
Get team statistics including placement and current score. Requires authentication and team membership.
Inputs: team_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 53 tools
Several tool pairs perform overlapping actions (e.g., admin_update_port vs service_update_port, overview_get_data vs overview_get_detailed_data, team_get_services vs team_get_services_status) with only permission scope or detail level differing. This makes it difficult for an agent to know which tool to invoke without deep context.
Tool names consistently follow a snake_case resource_action pattern with clear prefixes (admin_, service_, team_, etc.). Minor deviations like inject_get (singular) vs injects_list (plural) are understandable and do not cause confusion.
With 53 tools, the surface is overwhelming and exceeds the 'extreme mismatch' threshold. While the domain is complex, the sheer number of admin update variants and overlapping read/update tools makes it impractical for an agent to efficiently select the right tool.
The tool set provides broad coverage of the scoring engine's core domains: notifications, scoreboard, overview, teams, services, flags, injects, and extensive admin controls. Minor gaps exist (e.g., no mark-notification-read, no team/service CRUD beyond updates), but these are workaroundable.
Maintenance
Related MCP Connectors
Programmatic control of the Hiro security platform: scans, tasks, plans, and approvals.
Read NodePing checks, uptime, results and events; mute checks, manage maintenance and schedules.
Scopable MSP API: clients, quotes, assessments, compliance, QBRs. OAuth 2.1, read-only or read-write
Manage brainCloud apps, cloud code, hooks and servers; API lookups to help generate client code.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides programmatic access to CTFtime.org data for retrieving information about CTF competitions, team rankings, and event results. It enables users to search for upcoming events, analyze team performance, and access historical competition data through a standardized interface.94-
- AlicenseCqualityDmaintenanceEnables interaction with Hack The Box App services including machines, challenges, sherlocks, and more through the HTB API v4.601MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to the Intervals.icu API for interacting with training data, activities, events, and wellness information.7GPL 3.0
- AlicenseAqualityDmaintenanceEnables to access VEX Robotics Competition data including teams, events, rankings, skills scores, and forum via RobotEvents API.1512 npm2MIT