Resources

MCP resources expose passive read-only data at rampa:// URIs. Clients read them with resources/read.

All Runs

List every active and completed run.

all_runs
Run Details

Status, script path, event count for one run.

run_details
Run Metrics

All metrics for a run.

run_metrics
Specific Metric

Single metric by name.

run_metric
Threshold Results

Pass/fail results for each threshold expression.

run_thresholds
Event Log

Accumulated event history for a run.

run_events

All runs

all_runs

rampa://runs
resource application/json
resource application/json
rampa://runs

List all runs as JSON.

MIME type:
application/json

Read rampa://runs to list every active and completed run with their run_id, script_path, and current status.

Run details

run_details

rampa://runs/{run_id}
resource-template application/json
resource-template application/json
rampa://runs/{run_id}

Get details for a specific run.

MIME type:
application/json

Parameters

Argument

Type

Required

Description

run_id

string

yes

—

Read rampa://runs/{run_id} for status, script path, completion state, and event count.

Run metrics

run_metrics

rampa://runs/{run_id}/metrics
resource-template application/json
resource-template application/json
rampa://runs/{run_id}/metrics

Get all metrics for a run.

MIME type:
application/json

Parameters

Argument

Type

Required

Description

run_id

string

yes

—

Read rampa://runs/{run_id}/metrics for all metric values including timing percentiles, counters, and rates.

Specific metric

run_metric

rampa://runs/{run_id}/metrics/{name}
resource-template application/json
resource-template application/json
rampa://runs/{run_id}/metrics/{name}

Get a specific metric for a run.

MIME type:
application/json

Parameters

Argument

Type

Required

Description

run_id

string

yes

—

name

string

yes

—

Read rampa://runs/{run_id}/metrics/{name} to retrieve a single metric by name (e.g. http_req_duration, http_reqs).

Threshold results

run_thresholds

rampa://runs/{run_id}/thresholds
resource-template application/json
resource-template application/json
rampa://runs/{run_id}/thresholds

Get threshold results for a run.

MIME type:
application/json

Parameters

Argument

Type

Required

Description

run_id

string

yes

—

Read rampa://runs/{run_id}/thresholds for pass/fail results with source, passed, lhs (actual), and rhs (expected) for each threshold expression.

Event log

run_events

rampa://runs/{run_id}/events
resource-template application/json
resource-template application/json
rampa://runs/{run_id}/events

Get accumulated events for a run.

MIME type:
application/json

Parameters

Argument

Type

Required

Description

run_id

string

yes

—

Read rampa://runs/{run_id}/events for the accumulated event history including PhaseEvent, SnapshotEvent, and ThresholdEvent entries.