MCP Server¶

The rampa-mcp server lets AI agents inspect, start, control, and query load tests via the Model Context Protocol.

With uvx installed:

$ claude mcp add rampa -- uvx rampa-mcp

Config file: ~/.claude.json (this project)

With uvx installed:

$ claude mcp add rampa -- uvx --exclude-newer P7D --exclude-newer-package rampa-mcp=2099-01-01 rampa-mcp

Config file: ~/.claude.json (this project)

With uvx installed:

$ claude mcp add rampa -- uvx --no-config rampa-mcp

Config file: ~/.claude.json (this project)

With uvx installed:

$ claude mcp add rampa --scope user -- uvx rampa-mcp

Config file: ~/.claude.json (all projects)

With uvx installed:

$ claude mcp add rampa --scope user -- uvx --exclude-newer P7D --exclude-newer-package rampa-mcp=2099-01-01 rampa-mcp

Config file: ~/.claude.json (all projects)

With uvx installed:

$ claude mcp add rampa --scope user -- uvx --no-config rampa-mcp

Config file: ~/.claude.json (all projects)

With uvx installed:

$ claude mcp add rampa --scope project -- uvx rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

With uvx installed:

$ claude mcp add rampa --scope project -- uvx --exclude-newer P7D --exclude-newer-package rampa-mcp=2099-01-01 rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

With uvx installed:

$ claude mcp add rampa --scope project -- uvx --no-config rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

With pipx installed:

$ claude mcp add rampa -- pipx run rampa-mcp

Config file: ~/.claude.json (this project)

With pipx installed:

$ claude mcp add rampa -- pipx run rampa-mcp

pip has no per-package cooldown override, so this snippet runs without cooldown enforcement. Switch to the uvx tab — it applies the cooldown to transitive deps via `--exclude-newer` while exempting rampa-mcp itself via `--exclude-newer-package`.

Config file: ~/.claude.json (this project)

With pipx installed:

$ claude mcp add rampa -- pipx run rampa-mcp

Config file: ~/.claude.json (this project)

With pipx installed:

$ claude mcp add rampa --scope user -- pipx run rampa-mcp

Config file: ~/.claude.json (all projects)

With pipx installed:

$ claude mcp add rampa --scope user -- pipx run rampa-mcp

Config file: ~/.claude.json (all projects)

With pipx installed:

$ claude mcp add rampa --scope user -- pipx run rampa-mcp

Config file: ~/.claude.json (all projects)

With pipx installed:

$ claude mcp add rampa --scope project -- pipx run rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

With pipx installed:

$ claude mcp add rampa --scope project -- pipx run rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

With pipx installed:

$ claude mcp add rampa --scope project -- pipx run rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa -- rampa-mcp

Config file: ~/.claude.json (this project)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa -- rampa-mcp

Config file: ~/.claude.json (this project)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa -- rampa-mcp

Config file: ~/.claude.json (this project)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa --scope user -- rampa-mcp

Config file: ~/.claude.json (all projects)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa --scope user -- rampa-mcp

Config file: ~/.claude.json (all projects)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa --scope user -- rampa-mcp

Config file: ~/.claude.json (all projects)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa --scope project -- rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa --scope project -- rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ claude mcp add rampa --scope project -- rampa-mcp

Config file: .mcp.json (in repo, version-controlled)

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["rampa-mcp"]
        }
    }
}

Config file: claude_desktop_config.json

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["--exclude-newer", "P7D", "--exclude-newer-package", "rampa-mcp=2099-01-01", "rampa-mcp"]
        }
    }
}

Config file: claude_desktop_config.json

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["rampa-mcp"],
            "env": { "UV_NO_CONFIG": "1" }
        }
    }
}

Config file: claude_desktop_config.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: claude_desktop_config.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: claude_desktop_config.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: claude_desktop_config.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: claude_desktop_config.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: claude_desktop_config.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: claude_desktop_config.json

With uvx installed:

$ codex mcp add rampa -- uvx rampa-mcp

Config file: ~/.codex/config.toml

With uvx installed:

$ codex mcp add rampa -- uvx --exclude-newer P7D --exclude-newer-package rampa-mcp=2099-01-01 rampa-mcp

Config file: ~/.codex/config.toml

With uvx installed:

$ codex mcp add rampa -- uvx --no-config rampa-mcp

Config file: ~/.codex/config.toml

With uvx installed:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "uvx"
args = ["rampa-mcp"]

Config file: .codex/config.toml (in repo)

With uvx installed:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "uvx"
args = ["--exclude-newer", "P7D", "--exclude-newer-package", "rampa-mcp=2099-01-01", "rampa-mcp"]

Config file: .codex/config.toml (in repo)

With uvx installed:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "uvx"
args = ["rampa-mcp"]
env = { UV_NO_CONFIG = "1" }

Config file: .codex/config.toml (in repo)

With pipx installed:

$ codex mcp add rampa -- pipx run rampa-mcp

Config file: ~/.codex/config.toml

With pipx installed:

$ codex mcp add rampa -- pipx run rampa-mcp

Config file: ~/.codex/config.toml

With pipx installed:

$ codex mcp add rampa -- pipx run rampa-mcp

Config file: ~/.codex/config.toml

With pipx installed:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "pipx"
args = ["run", "rampa-mcp"]

Config file: .codex/config.toml (in repo)

With pipx installed:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "pipx"
args = ["run", "rampa-mcp"]

Config file: .codex/config.toml (in repo)

With pipx installed:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "pipx"
args = ["run", "rampa-mcp"]

Config file: .codex/config.toml (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ codex mcp add rampa -- rampa-mcp

Config file: ~/.codex/config.toml

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ codex mcp add rampa -- rampa-mcp

Config file: ~/.codex/config.toml

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ codex mcp add rampa -- rampa-mcp

Config file: ~/.codex/config.toml

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "rampa-mcp"

Config file: .codex/config.toml (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "rampa-mcp"

Config file: .codex/config.toml (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

Codex's CLI doesn't support project scope yet — paste this into .codex/config.toml at the repo root.

[mcp_servers.rampa]
command = "rampa-mcp"

Config file: .codex/config.toml (in repo)

With uvx installed:

$ gemini mcp add --scope user rampa uvx -- rampa-mcp

Config file: ~/.gemini/settings.json

With uvx installed:

$ gemini mcp add --scope user rampa uvx -- --exclude-newer P7D --exclude-newer-package rampa-mcp=2099-01-01 rampa-mcp

Config file: ~/.gemini/settings.json

With uvx installed:

$ gemini mcp add --scope user rampa uvx -- --no-config rampa-mcp

Config file: ~/.gemini/settings.json

With uvx installed:

$ gemini mcp add --scope project rampa uvx -- rampa-mcp

Config file: .gemini/settings.json (in repo)

With uvx installed:

$ gemini mcp add --scope project rampa uvx -- --exclude-newer P7D --exclude-newer-package rampa-mcp=2099-01-01 rampa-mcp

Config file: .gemini/settings.json (in repo)

With uvx installed:

$ gemini mcp add --scope project rampa uvx -- --no-config rampa-mcp

Config file: .gemini/settings.json (in repo)

With pipx installed:

$ gemini mcp add --scope user rampa pipx -- run rampa-mcp

Config file: ~/.gemini/settings.json

With pipx installed:

$ gemini mcp add --scope user rampa pipx -- run rampa-mcp

Config file: ~/.gemini/settings.json

With pipx installed:

$ gemini mcp add --scope user rampa pipx -- run rampa-mcp

Config file: ~/.gemini/settings.json

With pipx installed:

$ gemini mcp add --scope project rampa pipx -- run rampa-mcp

Config file: .gemini/settings.json (in repo)

With pipx installed:

$ gemini mcp add --scope project rampa pipx -- run rampa-mcp

Config file: .gemini/settings.json (in repo)

With pipx installed:

$ gemini mcp add --scope project rampa pipx -- run rampa-mcp

Config file: .gemini/settings.json (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ gemini mcp add --scope user rampa rampa-mcp

Config file: ~/.gemini/settings.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ gemini mcp add --scope user rampa rampa-mcp

Config file: ~/.gemini/settings.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ gemini mcp add --scope user rampa rampa-mcp

Config file: ~/.gemini/settings.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ gemini mcp add --scope project rampa rampa-mcp

Config file: .gemini/settings.json (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ gemini mcp add --scope project rampa rampa-mcp

Config file: .gemini/settings.json (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ gemini mcp add --scope project rampa rampa-mcp

Config file: .gemini/settings.json (in repo)

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["rampa-mcp"]
        }
    }
}

Config file: .cursor/mcp.json (in repo)

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["--exclude-newer", "P7D", "--exclude-newer-package", "rampa-mcp=2099-01-01", "rampa-mcp"]
        }
    }
}

Config file: .cursor/mcp.json (in repo)

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["rampa-mcp"],
            "env": { "UV_NO_CONFIG": "1" }
        }
    }
}

Config file: .cursor/mcp.json (in repo)

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["rampa-mcp"]
        }
    }
}

Config file: ~/.cursor/mcp.json

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["--exclude-newer", "P7D", "--exclude-newer-package", "rampa-mcp=2099-01-01", "rampa-mcp"]
        }
    }
}

Config file: ~/.cursor/mcp.json

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["rampa-mcp"],
            "env": { "UV_NO_CONFIG": "1" }
        }
    }
}

Config file: ~/.cursor/mcp.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: .cursor/mcp.json (in repo)

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: .cursor/mcp.json (in repo)

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: .cursor/mcp.json (in repo)

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: ~/.cursor/mcp.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: ~/.cursor/mcp.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: ~/.cursor/mcp.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: .cursor/mcp.json (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: .cursor/mcp.json (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: .cursor/mcp.json (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: ~/.cursor/mcp.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: ~/.cursor/mcp.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: ~/.cursor/mcp.json

With uvx installed:

$ grok mcp add --scope user rampa -- uvx rampa-mcp

Config file: ~/.grok/config.toml

With uvx installed:

$ grok mcp add --scope user rampa -- uvx --exclude-newer P7D --exclude-newer-package rampa-mcp=2099-01-01 rampa-mcp

Config file: ~/.grok/config.toml

With uvx installed:

$ grok mcp add --scope user rampa -- uvx --no-config rampa-mcp

Config file: ~/.grok/config.toml

With uvx installed:

$ grok mcp add --scope project rampa -- uvx rampa-mcp

Config file: ./.grok/config.toml (in repo)

With uvx installed:

$ grok mcp add --scope project rampa -- uvx --exclude-newer P7D --exclude-newer-package rampa-mcp=2099-01-01 rampa-mcp

Config file: ./.grok/config.toml (in repo)

With uvx installed:

$ grok mcp add --scope project rampa -- uvx --no-config rampa-mcp

Config file: ./.grok/config.toml (in repo)

With pipx installed:

$ grok mcp add --scope user rampa -- pipx run rampa-mcp

Config file: ~/.grok/config.toml

With pipx installed:

$ grok mcp add --scope user rampa -- pipx run rampa-mcp

Config file: ~/.grok/config.toml

With pipx installed:

$ grok mcp add --scope user rampa -- pipx run rampa-mcp

Config file: ~/.grok/config.toml

With pipx installed:

$ grok mcp add --scope project rampa -- pipx run rampa-mcp

Config file: ./.grok/config.toml (in repo)

With pipx installed:

$ grok mcp add --scope project rampa -- pipx run rampa-mcp

Config file: ./.grok/config.toml (in repo)

With pipx installed:

$ grok mcp add --scope project rampa -- pipx run rampa-mcp

Config file: ./.grok/config.toml (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ grok mcp add --scope user rampa -- rampa-mcp

Config file: ~/.grok/config.toml

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ grok mcp add --scope user rampa -- rampa-mcp

Config file: ~/.grok/config.toml

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ grok mcp add --scope user rampa -- rampa-mcp

Config file: ~/.grok/config.toml

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ grok mcp add --scope project rampa -- rampa-mcp

Config file: ./.grok/config.toml (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ grok mcp add --scope project rampa -- rampa-mcp

Config file: ./.grok/config.toml (in repo)

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then register:

$ grok mcp add --scope project rampa -- rampa-mcp

Config file: ./.grok/config.toml (in repo)

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["rampa-mcp"]
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["--exclude-newer", "P7D", "--exclude-newer-package", "rampa-mcp=2099-01-01", "rampa-mcp"]
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

With uvx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "uvx",
            "args": ["rampa-mcp"],
            "env": { "UV_NO_CONFIG": "1" }
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

With pipx installed:

{
    "mcpServers": {
        "rampa": {
            "command": "pipx",
            "args": ["run", "rampa-mcp"]
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

Install the packages first:

$ pip install --user --upgrade rampa-mcp

Then use this config:

{
    "mcpServers": {
        "rampa": {
            "command": "rampa-mcp"
        }
    }
}

Config file: ~/.gemini/config/mcp_config.json

Tools

Inspect scripts, control runs, and query load test results.

Tools

Resources

URI templates for runs, metrics, and thresholds.

Resources

API Reference

Server factory, run registry, and models.

API Reference

What you can do¶

Load Testing¶

Start and manage load test runs from AI agents. start_run · stop_run · pause_run · resume_run · get_status · list_runs

Discovery readonly¶

Inspect scripts before you run them. discover_scenarios · inspect_config

Observability¶

Query metrics and threshold results for completed runs. get_metrics · get_thresholds