hotpath-cloud is an MCP server published by rs.hotpath, hosted at hotpath.rs. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 8 tools, including get_default_policy, get_diff, get_report, list_benchmarks, list_reports.
Read-only access to Rust profiling reports from CI: benchmark history, diffs and policies
Nothing else in the archive shares these values.
Get the default policy document. Save it as hotpath/policy.toml (or hotpath/<benchmark>-policy.toml), edit it, then check it with validate_policy.
No parameters.
{
"name": "get_default_policy",
"title": "Get Default Policy",
"description": "Get the default policy document. Save it as hotpath/policy.toml (or hotpath/<benchmark>-policy.toml), edit it, then check it with validate_policy.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Compare a report with its baseline, as the PR comment does: regressions, improvements and broken budgets. Read the top-level `verdict` first.
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
| Parameter | Type | Description |
|---|---|---|
| id | ["string","null"] | A report id as the head. |
| pr | ["integer","null"] | Pull request number: the PR's newest report is the head. One of `pr`, `commit`, `id`. |
| repo * | string | The repository as `owner/name`, as `list_repos` prints it. |
| rows | any | `findings` (default without `select`): the rows the PR comment lists. `advisory`: plus the findings of unjudged families. `all` (default with `select`): every row, cell and total. |
| event | any | Narrows `pr` / `commit` to one event; not with `id`. |
| commit | ["string","null"] | Full 40-character commit sha: the newest report measuring it or headed at it is the head. |
| select | any | Keep only the rows and omissions of these entities, as in get_report: per resource exact `keys`; an io label keeps every op row of it. A section left without any is dropped. Combines with `rows`. |
| precise | ["boolean","null"] | `true`: values, changes and budget figures unrounded, durations in `ns`, sizes in `B`. Default `false`: rounded for reading. |
| benchmark * | string | The benchmark name, as `list_benchmarks` prints it. |
{
"name": "get_diff",
"title": "Compare Report With Baseline",
"description": "Compare a report with its baseline, as the PR comment does: regressions, improvements and broken budgets. Read the top-level `verdict` first.",
"inputSchema": {
"type": "object",
"$defs": {
"Rows": {
"enum": [
"findings",
"advisory",
"all"
],
"type": "string"
},
"Event": {
"enum": [
"push",
"pull_request"
],
"type": "string"
},
"Select": {
"type": "object",
"properties": {
"io": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "I/O keys: the value's label (`sock`), never `label | operation | -`;\nit keeps the value's whole payload entry and every op row of it in a\ndiff."
},
"sql": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "SQL keys: `query | route | source`, `-` for a part the entry lacks."
},
"http": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "HTTP call keys: `name | route | source`, `-` for a part the entry lacks."
},
"server": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Route keys: the route (`GET /users/{id}`)."
},
"mutexes": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Mutex keys: the label."
},
"threads": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Thread keys: the thread name; keeps every thread of that name in a\npayload and the diff's row summing them."
},
"channels": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Channel keys: the label."
},
"rw_locks": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "RwLock keys: the label."
},
"functions": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Function keys: the function name (`crate::module::fn`)."
}
},
"description": "`select=` as sent: per resource, exact entity keys.\nShared by the REST query and the MCP tools, whose schema it is.",
"additionalProperties": false
},
"ResourceSelect": {
"type": "object",
"required": [
"keys"
],
"properties": {
"keys": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact, case-sensitive entity keys. Their format depends on the\nresource and is given by its field of `Select`; mostly a diff row's\n`key`, but io takes the value's label and keeps every operation of it."
}
},
"description": "One resource of a `Select`: the entities to read, each with every\nsection and value the report has of it.",
"additionalProperties": false
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"repo",
"benchmark"
],
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "A report id as the head."
},
"pr": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Pull request number: the PR's newest report is the head. One of `pr`,\n`commit`, `id`."
},
"repo": {
"type": "string",
"description": "The repository as `owner/name`, as `list_repos` prints it."
},
"rows": {
"anyOf": [
{
"$ref": "#/$defs/Rows"
},
{
"type": "null"
}
],
"description": "`findings` (default without `select`): the rows the PR comment lists.\n`advisory`: plus the findings of unjudged families. `all` (default\nwith `select`): every row, cell and total."
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/Event"
},
{
"type": "null"
}
],
"description": "Narrows `pr` / `commit` to one event; not with `id`."
},
"commit": {
"type": [
"string",
"null"
],
"description": "Full 40-character commit sha: the newest report measuring it or headed\nat it is the head."
},
"select": {
"anyOf": [
{
"$ref": "#/$defs/Select"
},
{
"type": "null"
}
],
"description": "Keep only the rows and omissions of these entities, as in get_report:\nper resource exact `keys`; an io label keeps every op row of it. A\nsection left without any is dropped. Combines with `rows`."
},
"precise": {
"type": [
"boolean",
"null"
],
"description": "`true`: values, changes and budget figures unrounded, durations in\n`ns`, sizes in `B`. Default `false`: rounded for reading."
},
"benchmark": {
"type": "string",
"description": "The benchmark name, as `list_benchmarks` prints it."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch one report: its summary, verdict and policy, optionally with its hotpath JSON payload. not_found means CI has not uploaded it yet. For what changed against the baseline, use get_diff.
| Parameter | Type | Description |
|---|---|---|
| id | ["string","null"] | A report id. |
| pr | ["integer","null"] | Pull request number: the PR's newest report. One of `pr`, `commit`, `id`. |
| repo * | string | The repository as `owner/name`, as `list_repos` prints it. |
| event | any | Narrows `pr` / `commit` to one event; not with `id`. |
| commit | ["string","null"] | Full 40-character commit sha: the newest report measuring it or headed at it (a PR branch's `git rev-parse HEAD` finds the PR's report). |
| select | any | Keep only these entities in the payload, per resource (`functions`, `sql`, `http`, `server`, `mutexes`, `rw_locks`, `channels`, `io`, `threads`) exact, case-sensitive `keys` (function name; sql and http `name | route | source` with `-` for a missing part; io the value's label, every op of it; server… |
| precise | ["boolean","null"] | `true`: measurements unrounded, durations in `ns`, sizes in `B` (payload values as uploaded). Default `false`: rounded for reading. |
| benchmark * | string | The benchmark name, as `list_benchmarks` prints it. |
| include_payload | ["boolean","null"] | Include the uploaded hotpath JSON report. Default: false without `select`, true with it; `false` with `select` is refused. |
{
"name": "get_report",
"title": "Get Report",
"description": "Fetch one report: its summary, verdict and policy, optionally with its hotpath JSON payload. not_found means CI has not uploaded it yet. For what changed against the baseline, use get_diff.",
"inputSchema": {
"type": "object",
"$defs": {
"Event": {
"enum": [
"push",
"pull_request"
],
"type": "string"
},
"Select": {
"type": "object",
"properties": {
"io": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "I/O keys: the value's label (`sock`), never `label | operation | -`;\nit keeps the value's whole payload entry and every op row of it in a\ndiff."
},
"sql": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "SQL keys: `query | route | source`, `-` for a part the entry lacks."
},
"http": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "HTTP call keys: `name | route | source`, `-` for a part the entry lacks."
},
"server": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Route keys: the route (`GET /users/{id}`)."
},
"mutexes": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Mutex keys: the label."
},
"threads": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Thread keys: the thread name; keeps every thread of that name in a\npayload and the diff's row summing them."
},
"channels": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Channel keys: the label."
},
"rw_locks": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "RwLock keys: the label."
},
"functions": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Function keys: the function name (`crate::module::fn`)."
}
},
"description": "`select=` as sent: per resource, exact entity keys.\nShared by the REST query and the MCP tools, whose schema it is.",
"additionalProperties": false
},
"ResourceSelect": {
"type": "object",
"required": [
"keys"
],
"properties": {
"keys": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact, case-sensitive entity keys. Their format depends on the\nresource and is given by its field of `Select`; mostly a diff row's\n`key`, but io takes the value's label and keeps every operation of it."
}
},
"description": "One resource of a `Select`: the entities to read, each with every\nsection and value the report has of it.",
"additionalProperties": false
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"repo",
"benchmark"
],
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "A report id."
},
"pr": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Pull request number: the PR's newest report. One of `pr`, `commit`, `id`."
},
"repo": {
"type": "string",
"description": "The repository as `owner/name`, as `list_repos` prints it."
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/Event"
},
{
"type": "null"
}
],
"description": "Narrows `pr` / `commit` to one event; not with `id`."
},
"commit": {
"type": [
"string",
"null"
],
"description": "Full 40-character commit sha: the newest report measuring it or headed\nat it (a PR branch's `git rev-parse HEAD` finds the PR's report)."
},
"select": {
"anyOf": [
{
"$ref": "#/$defs/Select"
},
{
"type": "null"
}
],
"description": "Keep only these entities in the payload, per resource\n(`functions`, `sql`, `http`, `server`, `mutexes`, `rw_locks`, `channels`,\n`io`, `threads`) exact, case-sensitive `keys` (function name; sql and\nhttp `name | route | source` with `-` for a missing part; io the\nvalue's label, every op of it; server the route; locks and channels\nthe label; threads the thread name, every thread of it). Up to 20 keys."
},
"precise": {
"type": [
"boolean",
"null"
],
"description": "`true`: measurements unrounded, durations in `ns`, sizes in `B`\n(payload values as uploaded). Default `false`: rounded for reading."
},
"benchmark": {
"type": "string",
"description": "The benchmark name, as `list_benchmarks` prints it."
},
"include_payload": {
"type": [
"boolean",
"null"
],
"description": "Include the uploaded hotpath JSON report. Default: false without\n`select`, true with it; `false` with `select` is refused."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List one repository's benchmarks.
| Parameter | Type | Description |
|---|---|---|
| repo * | string | The repository as `owner/name`, as `list_repos` prints it. |
{
"name": "list_benchmarks",
"title": "List Benchmarks",
"description": "List one repository's benchmarks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"repo"
],
"properties": {
"repo": {
"type": "string",
"description": "The repository as `owner/name`, as `list_repos` prints it."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List a repository's reports, newest first, as summaries with their run totals. Use it to browse report history; with `select`, to follow given entities across runs.
| Parameter | Type | Description |
|---|---|---|
| pr | ["integer","null"] | Only this pull request's reports. |
| repo * | string | The repository as `owner/name`, as `list_repos` prints it. |
| event | any | Only reports of one event. |
| limit | ["integer","null"] | Reports per page, 1 to 50, default 20; with `select` 1 to 20, default 10. |
| since | ["string","null"] | Uploaded at or after this time: RFC 3339, or `YYYY-MM-DD` (UTC midnight). |
| until | ["string","null"] | Uploaded before this time, same format as `since`. |
| branch | ["string","null"] | Bare branch name (`main`): reports that measured that branch's ref, in practice its push reports; pair with `event: push` for the baseline series. For a PR's own reports use `pr`. |
| commit | ["string","null"] | Full 40-character commit sha: reports measuring it or headed at it. |
| cursor | ["string","null"] | `next_cursor` of the previous page, with the same filters. |
| select | any | Return each report with its payload, filtered as get_report's `select`. |
| precise | ["boolean","null"] | As get_report's `precise`. |
| verdict | any | `passed`, `regressed` (failed reports included), `failed`, or `not_judged` (nothing was judged). |
| metadata | ["object","null"] | Only reports whose user_metadata has all of these keys with exactly these values (e.g. {"runner": "Linux-ARM64"}); up to 8 pairs. Reports without metadata never match. |
| benchmark | ["string","null"] | Only this benchmark's reports, by name as `list_benchmarks` prints it. Default: every benchmark of the repository. |
{
"name": "list_reports",
"title": "List Reports",
"description": "List a repository's reports, newest first, as summaries with their run totals. Use it to browse report history; with `select`, to follow given entities across runs.",
"inputSchema": {
"type": "object",
"$defs": {
"Event": {
"enum": [
"push",
"pull_request"
],
"type": "string"
},
"Select": {
"type": "object",
"properties": {
"io": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "I/O keys: the value's label (`sock`), never `label | operation | -`;\nit keeps the value's whole payload entry and every op row of it in a\ndiff."
},
"sql": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "SQL keys: `query | route | source`, `-` for a part the entry lacks."
},
"http": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "HTTP call keys: `name | route | source`, `-` for a part the entry lacks."
},
"server": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Route keys: the route (`GET /users/{id}`)."
},
"mutexes": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Mutex keys: the label."
},
"threads": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Thread keys: the thread name; keeps every thread of that name in a\npayload and the diff's row summing them."
},
"channels": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Channel keys: the label."
},
"rw_locks": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "RwLock keys: the label."
},
"functions": {
"anyOf": [
{
"$ref": "#/$defs/ResourceSelect"
},
{
"type": "null"
}
],
"description": "Function keys: the function name (`crate::module::fn`)."
}
},
"description": "`select=` as sent: per resource, exact entity keys.\nShared by the REST query and the MCP tools, whose schema it is.",
"additionalProperties": false
},
"Verdict": {
"enum": [
"passed",
"regressed",
"failed",
"not_judged"
],
"type": "string"
},
"ResourceSelect": {
"type": "object",
"required": [
"keys"
],
"properties": {
"keys": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact, case-sensitive entity keys. Their format depends on the\nresource and is given by its field of `Select`; mostly a diff row's\n`key`, but io takes the value's label and keeps every operation of it."
}
},
"description": "One resource of a `Select`: the entities to read, each with every\nsection and value the report has of it.",
"additionalProperties": false
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"repo"
],
"properties": {
"pr": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Only this pull request's reports."
},
"repo": {
"type": "string",
"description": "The repository as `owner/name`, as `list_repos` prints it."
},
"event": {
"anyOf": [
{
"$ref": "#/$defs/Event"
},
{
"type": "null"
}
],
"description": "Only reports of one event."
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Reports per page, 1 to 50, default 20; with `select` 1 to 20,\ndefault 10."
},
"since": {
"type": [
"string",
"null"
],
"description": "Uploaded at or after this time: RFC 3339, or `YYYY-MM-DD` (UTC midnight)."
},
"until": {
"type": [
"string",
"null"
],
"description": "Uploaded before this time, same format as `since`."
},
"branch": {
"type": [
"string",
"null"
],
"description": "Bare branch name (`main`): reports that measured that branch's ref,\nin practice its push reports; pair with `event: push` for the\nbaseline series. For a PR's own reports use `pr`."
},
"commit": {
"type": [
"string",
"null"
],
"description": "Full 40-character commit sha: reports measuring it or headed at it."
},
"cursor": {
"type": [
"string",
"null"
],
"description": "`next_cursor` of the previous page, with the same filters."
},
"select": {
"anyOf": [
{
"$ref": "#/$defs/Select"
},
{
"type": "null"
}
],
"description": "Return each report with its payload, filtered as get_report's `select`."
},
"precise": {
"type": [
"boolean",
"null"
],
"description": "As get_report's `precise`."
},
"verdict": {
"anyOf": [
{
"$ref": "#/$defs/Verdict"
},
{
"type": "null"
}
],
"description": "`passed`, `regressed` (failed reports included), `failed`, or\n`not_judged` (nothing was judged)."
},
"metadata": {
"type": [
"object",
"null"
],
"description": "Only reports whose user_metadata has all of these keys with exactly\nthese values (e.g. {\"runner\": \"Linux-ARM64\"}); up to 8 pairs. Reports\nwithout metadata never match.",
"additionalProperties": {
"type": "string"
}
},
"benchmark": {
"type": [
"string",
"null"
],
"description": "Only this benchmark's reports, by name as `list_benchmarks` prints it.\nDefault: every benchmark of the repository."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the repositories with the hotpath GitHub App installed, with their benchmarks. Start here: `full_name` is the `repo` argument of the other tools.
| Parameter | Type | Description |
|---|---|---|
| query | ["string","null"] | Only repositories whose `owner/name` contains this text, ignoring case. |
| with_benchmarks | boolean | Only repositories with at least one benchmark. Default false. |
{
"name": "list_repos",
"title": "List Repositories",
"description": "List the repositories with the hotpath GitHub App installed, with their benchmarks. Start here: `full_name` is the `repo` argument of the other tools.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": [
"string",
"null"
],
"description": "Only repositories whose `owner/name` contains this text, ignoring case."
},
"with_benchmarks": {
"type": "boolean",
"default": false,
"description": "Only repositories with at least one benchmark. Default false."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check a policy TOML document. Use it after editing a policy file, before committing it.
| Parameter | Type | Description |
|---|---|---|
| source * | string | The whole policy TOML document, as written. |
{
"name": "validate_policy",
"title": "Validate Policy",
"description": "Check a policy TOML document. Use it after editing a policy file, before committing it.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"source"
],
"properties": {
"source": {
"type": "string",
"description": "The whole policy TOML document, as written."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Show the GitHub user and API token this connection acts as. Use it to check the connection or after an invalid_token error.
No parameters.
{
"name": "whoami",
"title": "Show Current User",
"description": "Show the GitHub user and API token this connection acts as. Use it to check the connection or after an invalid_token error.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}hotpath-cloud: Rust profiling reports from CI, their diffs against the baseline and the policies that judge them; not the live profiler of a running process. Every tool is read-only. list_repos lists the repositories of the user's own GitHub App installations; a repository with public reports can be named directly as owner/name without appearing there. list_reports finds a benchmark's report history, get_report fetches one report, get_diff explains its regressions and improvements against the baseline.
Names, descriptions and schemas were written by the server and are shown as data.