Skip to main content
Glama
Scoring Engine MCP Server

Scoring Engine MCP Server

Official

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 build

Configuration

Set the following environment variables:

Variable

Description

Default

SCORING_ENGINE_URL

Base URL of your Scoring Engine instance

http://localhost

SCORING_ENGINE_SESSION

Session cookie value for authentication

(empty)

  1. Log in to your Scoring Engine instance in a web browser

  2. Open Developer Tools (F12)

  3. Go to Application > Cookies

  4. Copy the value of the session cookie

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 data

  • scoreboard_get_line_data - Get team line chart data

Overview Tools

  • overview_get_round_data - Get current round info

  • overview_get_data - Get team/service overview

  • overview_get_columns - Get column headers

  • overview_get_detailed_data - Get detailed data for display

Team Tools

  • team_get_stats - Get team placement and score

  • team_get_services - Get team's services with details

  • team_get_services_status - Get current service status

Service Tools

  • service_get_checks - Get check history

  • service_update_account - Update account credentials

  • service_update_host - Update service hostname

  • service_update_port - Update service port

Stats Tools

  • stats_get_rounds - Get round statistics

Flags Tools (Red/White team)

  • flags_get_active - Get active flags

  • flags_get_solves - Get solve status

  • flags_get_totals - Get scoring totals

Injects Tools

  • injects_list - List team injects

  • inject_get - Get inject details

  • inject_submit - Submit an inject

  • inject_get_comments - Get inject comments

  • inject_add_comment - Add a comment

  • inject_get_files - List inject files

Notifications Tools

  • notifications_list - List all notifications

  • notifications_unread - Get unread notifications

Admin Tools (White team only)

  • admin_get_teams - List all teams

  • admin_add_user - Create user

  • admin_add_team - Create team

  • admin_update_password - Change user password

  • admin_toggle_engine - Pause/resume engine

  • admin_get_engine_status - Check if paused

  • admin_get_engine_stats - Get engine statistics

  • admin_get_worker_stats - Get worker stats

  • admin_get_queue_stats - Get queue stats

  • admin_get_round_progress - Get round progress

  • admin_update_check - Modify check results

  • admin_update_host - Change service host

  • admin_update_port - Change service port

  • admin_update_points - Update point values

  • admin_update_worker_queue - Assign worker queue

  • admin_update_target_round_time - Set round duration

  • admin_update_worker_refresh_time - Set refresh interval

  • admin_injects_get_templates - List inject templates

  • admin_injects_get_template - Get template details

  • admin_injects_create_template - Create template

  • admin_injects_update_template - Update template

  • admin_injects_delete_template - Delete template

  • admin_inject_grade - Grade an inject

  • admin_injects_get_scores - Get inject scores

  • admin_injects_get_bar_chart - Get inject chart data

  • admin_update_setting - Update settings

  • admin_update_environment_info - Update environment

  • admin_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 dev

License

MIT

Available Tools

53 tools
admin_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

    B3.2/5.0

    Scored across 53 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers