MCP server · Ravel

Endpoint

Streamable HTTP

Point an MCP client at https://ravel.dbg.re/mcp. No authentication is needed.

Clients that add remote servers by URL, including the connector settings of desktop and web assistants, take the endpoint as is. Clients that only start local servers reach it through mcp-remote.

Claude CodeTerminal

claude mcp add --transport http ravel https://ravel.dbg.re/mcp

Codex~/.codex/config.toml

[mcp_servers.ravel]
url = "https://ravel.dbg.re/mcp"

VS Code.vscode/mcp.json

{
  "servers": {
    "ravel": {"type": "http", "url": "https://ravel.dbg.re/mcp"}
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "ravel": {"url": "https://ravel.dbg.re/mcp"}
  }
}

Local-only clientsstdio bridge

npx -y mcp-remote https://ravel.dbg.re/mcp

Tools

Each tool returns its result as JSON text.

TOOLlist_builds

List builds in catalogue order

Arguments

None.

TOOLget_build

Get a build by its exact public token

Arguments

Name	Type	Requirement	Rules	Description
`build`	`string`	required	-	Exact public build token.

TOOLlist_build_binaries

List binaries in a build

Arguments

Name	Type	Requirement	Rules	Description
`build`	`string`	required	-	Exact public build token.
`offset`	`integer`	optional	default 0 · minimum 0	Zero-based result offset.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Page size.

TOOLlist_build_record_classes

List record collections and availability

Arguments

Name	Type	Requirement	Rules	Description
`build`	`string`	required	-	Exact public build token.

TOOLlist_build_records

Browse one record collection in a build

Arguments

Name	Type	Requirement	Rules	Description
`build`	`string`	required	-	Exact public build token.
`class`	`string`	required	-	Record collection returned by the build record-classes resource.
`offset`	`integer`	optional	default 0 · minimum 0	Zero-based result offset.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Page size.

TOOLlookup_build_binary

Resolve an exact binary locator

Arguments

Name	Type	Requirement	Rules	Description
`build`	`string`	required	-	Exact public build token.
`domain`	`string`	required	-	Exact source domain.
`path`	`string`	required	-	Exact logical binary path.

TOOLquery_binary_facts

Query facts for an exact binary locator

direction must be absent when sort is absent. detail filtering and sorting are valid only for entitlement and plist_entry classes.

Arguments

Name	Type	Requirement	Rules	Description
`build`	`string`	required	-	Exact public build token.
`domain`	`string`	required	-	Exact source domain.
`path`	`string`	required	-	Exact logical binary path.
`class`	`string`	optional	-	Optional record class, trimmed and limited to 256 UTF-8 bytes.
`query`	`string`	optional	-	Optional text after trimming, at most 256 UTF-8 bytes.
`filter_collection`	`string`	optional	-	Case-insensitive collection filter, trimmed and limited to 256 UTF-8 bytes.
`filter_value`	`string`	optional	-	Case-insensitive value filter, trimmed and limited to 256 UTF-8 bytes.
`filter_origin`	`string`	optional	-	Case-insensitive origin filter, trimmed and limited to 256 UTF-8 bytes.
`filter_detail`	`string`	optional	-	Case-insensitive projected detail filter, trimmed and limited to 256 UTF-8 bytes.
`filter_address`	`string`	optional	-	Case-insensitive rendered address filter, trimmed and limited to 256 UTF-8 bytes.
`filter_count`	`string`	optional	-	Case-insensitive rendered count filter, trimmed and limited to 256 UTF-8 bytes.
`sort`	`string`	optional	one of "collection", "value", "origin", "detail", "address", "count"	Fact sort column.
`direction`	`string`	optional	default "asc" · one of "asc", "desc"	Sort direction. Defaults to asc when sorting applies.
`offset`	`integer`	optional	default 0 · minimum 0	Zero-based result offset.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Page size.

TOOLlist_entitlement_holders

Page exact entitlement holders in a build

Exact, case-sensitive top-level key lookup across all indexed domains, deduplicated by binary and canonical value. Key is trimmed and limited to 256 UTF-8 bytes. Order is domain, logical path, binary identity, then value. To continue comparison previews, page from offset zero and retain domains in the comparison's common_coverage. This endpoint may also include domains outside the comparison.

Arguments

Name	Type	Requirement	Rules	Description
`build`	`string`	required	-	Exact public build token.
`key`	`string`	required	-	Exact case-sensitive entitlement key.
`offset`	`integer`	optional	default 0 · minimum 0	Zero-based result offset.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Page size.

TOOLsearch_binaries

Search binary logical paths across builds

Arguments

Name	Type	Requirement	Rules	Description
`query`	`string`	required	-	Nonempty text after trimming, at most 256 UTF-8 bytes.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Maximum number of ranked results.

TOOLsearch_records

Search record values across builds

Matches indexed record values and the code-signing identifiers of code identities, whose indexed value is the CodeDirectory hash. contains mode requires at least three Unicode characters after trimming.

Arguments

Name	Type	Requirement	Rules	Description
`query`	`string`	required	-	Nonempty text after trimming, at most 256 UTF-8 bytes.
`mode`	`string`	optional	default "prefix" · one of "prefix", "exact", "contains"	Record search mode.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Maximum number of ranked results.

TOOLsearch_entitlements

Search entitlement records

Arguments

Name	Type	Requirement	Rules	Description
`query`	`string`	required	-	Nonempty text after trimming, at most 256 UTF-8 bytes.
`offset`	`integer`	optional	default 0 · minimum 0	Zero-based result offset.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Page size.

TOOLcompare_builds

Compare complete builds

base and target must be supplied together. When both are absent, the latest compatible pair is selected.

Arguments

Name	Type	Requirement	Rules	Description
`base`	`string`	optional	-	Baseline public build token. Must be paired with target.
`target`	`string`	optional	-	Target public build token. Must be paired with base.
`domain`	`string`	optional	-	Optional exact source domain, trimmed and limited to 256 UTF-8 bytes.
`status`	`string`	optional	one of "surface", "content", "metadata", "unchanged", "added", "removed"	Build component change classification.
`class`	`string`	optional	-	Optional record class, trimmed and limited to 256 UTF-8 bytes.
`query`	`string`	optional	-	Optional text after trimming, at most 256 UTF-8 bytes.
`hide_content`	`boolean`	optional	default true	Hide non-semantic content-only changes. Only lowercase true or false is accepted.
`filter_change`	`string`	optional	-	Case-insensitive rendered change filter, trimmed and limited to 256 UTF-8 bytes.
`filter_domain`	`string`	optional	-	Case-insensitive source-domain filter, trimmed and limited to 256 UTF-8 bytes.
`filter_path`	`string`	optional	-	Case-insensitive logical-path filter, trimmed and limited to 256 UTF-8 bytes.
`filter_version`	`string`	optional	-	Case-insensitive binary-version filter, trimmed and limited to 256 UTF-8 bytes.
`filter_size`	`string`	optional	-	Case-insensitive rendered size filter, trimmed and limited to 256 UTF-8 bytes.
`filter_records`	`string`	optional	-	Case-insensitive rendered record-count filter, trimmed and limited to 256 UTF-8 bytes.
`filter_collections`	`string`	optional	-	Case-insensitive changed-collection filter, trimmed and limited to 256 UTF-8 bytes.
`sort`	`string`	optional	default "change" · one of "change", "domain", "path", "version", "size", "records", "collections"	Build component sort column.
`direction`	`string`	optional	default "asc" · one of "asc", "desc"	Sort direction. Defaults to asc when sorting applies.
`offset`	`integer`	optional	default 0 · minimum 0	Zero-based result offset.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Page size.

TOOLcompare_binary

Compare one binary across builds

base and target must be supplied together. When both are absent, the latest compatible pair is selected. An ambiguous path returns candidate source domains.

Arguments

Name	Type	Requirement	Rules	Description
`base`	`string`	optional	-	Baseline public build token. Must be paired with target.
`target`	`string`	optional	-	Target public build token. Must be paired with base.
`domain`	`string`	optional	-	Optional exact source domain, trimmed and limited to 256 UTF-8 bytes.
`path`	`string`	required	-	Exact logical binary path.
`class`	`string`	optional	-	Optional record class, trimmed and limited to 256 UTF-8 bytes.
`change`	`string`	optional	one of "updated", "added", "removed"	Exact record change type.
`hide_content`	`boolean`	optional	default true	Hide non-semantic content-only changes. Only lowercase true or false is accepted.
`offset`	`integer`	optional	default 0 · minimum 0	Zero-based result offset.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Page size.

TOOLcompare_entitlements

Compare entitlements across builds

base and target must be supplied together. When both are absent, the latest compatible pair is selected. query matches entitlement keys or changed holder domains, paths, and values before pagination. Unchanged holders do not produce a match. Each entry's base and target arrays preview at most holders_limit (100) holders in shared complete domains, including unchanged holders, ordered by domain, logical path, and canonical value. base_total and target_total are exact. Retrieve complete evidence through list_entitlement_holders with the entry key, paging from offset zero and retaining common_coverage domains. Its pages include all indexed domains.

Arguments

Name	Type	Requirement	Rules	Description
`base`	`string`	optional	-	Baseline public build token. Must be paired with target.
`target`	`string`	optional	-	Target public build token. Must be paired with base.
`query`	`string`	optional	-	Optional text after trimming, at most 256 UTF-8 bytes.
`offset`	`integer`	optional	default 0 · minimum 0	Zero-based result offset.
`limit`	`integer`	optional	default 25 · minimum 1 · maximum 200	Page size.

Errors

Failed calls say whether to change the request or retry later.

Requests over the rate limit get HTTP 429 with a Retry-After header.

A failed tool call returns its error as JSON text and is marked isError. bad_request names the argument to fix, query_too_large asks for a narrower query, busy says how long to wait before retrying, and unavailable can be retried after a pause.

Rate limiting counts requests per network address, as described in the privacy notice.