> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Polar Signals MCP

> Polar Signals MCP lets engineering agents inspect continuous profiling projects and performance data to diagnose regressions and optimization opportunities.

![Polar Signals MCP logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/polar_signals_mcp.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=fd9c8cfd250f68d05c9bd7ecd1de58fa)

* **Category:** model context protocol
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 8
* **Triggers:** 0
* **Slug:** `POLAR_SIGNALS_MCP`
* **Version:** 20260924\_00

## Tools

> [accordion] List projects
>
> **Slug:** `POLAR_SIGNALS_MCP_LIST_PROJECTS`
>
> List all projects accessible to the current user. IMPORTANT: Call this FIRST before using any other tools. Returns project IDs and names. You need a project ID for all other tool calls. If only one project is returned, use it automatically. If a project is specified in the user's instructions (e.g. claude.md or system prompt), prefer that one. Otherwise, ask the user which project to use.

> [accordion] Query profile flamegraph
>
> **Slug:** `POLAR_SIGNALS_MCP_QUERY_PROFILE_FLAMEGRAPH`
>
> Return a flame graph as a breadth-first call tree. Each row has id, parent (the parent row's id, -1 = a root), depth, cumulative, flat, function\_name — rebuild the tree via the parent pointers. Unsymbolized frames (no function\_name) instead carry their hex memory address in an extra 'address' column, shown only when such frames are present. Use this for a top-down picture of where time goes; 'query\_profile\_table' gives a flat ranked list and 'query\_profile\_sandwich' focuses on one function. Drill into a subtree with 'focus\_path'. Same query syntax as 'query\_profile\_table'.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Query in format 'profile\_type' or 'profile\_type\{label="value", ...}'. Use exact profile type from 'profile\_types' (e.g. 'parca\_agent:samples:count:cpu:nanoseconds:delta'), not shortened names. Matchers: = != =\~ !\~.
>
> **end\_time** `string`
>
> Absolute end time in RFC3339 format (e.g. '2025-01-15T11:00:00Z'). Defaults to now if only 'start\_time' is provided.
>
> **max\_depth** `integer`
>
> Maximum tree depth to return — the first call shows just the top of the graph. Defaults to 6. Raise it to see deeper (focus\_path narrows which branches are shown, not the depth). Use 0 for the full (5%-trimmed) tree.
>
> **focus\_path** `array`
>
> Focus breadcrumb: the exact call path from a root frame (depth 0) downward, as an ordered list read off a prior call's rows (e.g. \["runtime.main"], then \["runtime.main", "handler"]). Use the function\_name for symbolized frames, or the hex value from the 'address' column for unsymbolized frames (e.g. "0x97a0235") to descend into native/kernel stacks. Entries may be mixed. Filters the flame graph to stacks following that path — sibling branches are removed while the tree stays rooted at the true root. Omit for the whole-profile flame graph. Append an entry to narrow further, drop the last to widen.
>
> **project\_id** `string` *required*
>
> The project ID to query. Get this from the 'list\_projects' tool.
>
> **start\_time** `string`
>
> Absolute start time in RFC3339 format (e.g. '2025-01-15T10:00:00Z'). Takes precedence over 'time\_range'.
>
> **time\_range** `string`
>
> Relative time range for the profile (e.g. '15m', '1h', '24h'). Used when 'start\_time' is not provided.

> [accordion] Query profile labels
>
> **Slug:** `POLAR_SIGNALS_MCP_QUERY_PROFILE_LABELS`
>
> Get available label names for a specific profile type. Call this after 'profile\_types' to discover what labels exist. You MUST use exact profile type strings from 'profile\_types' output. Returns label names that can be used with 'values' and in 'query\_profile\_table' queries - do not invent label names.
>
> #### Input Parameters
>
> **end\_time** `string`
>
> Absolute end time in RFC3339 format (e.g. '2025-01-15T11:00:00Z'). Defaults to now if only 'start\_time' is provided.
>
> **project\_id** `string` *required*
>
> The project ID to query. Get this from the 'list\_projects' tool.
>
> **start\_time** `string`
>
> Absolute start time in RFC3339 format (e.g. '2025-01-15T10:00:00Z'). Takes precedence over 'time\_range'.
>
> **time\_range** `string`
>
> Relative time range for the profile (e.g. '15m', '1h', '24h'). Used when 'start\_time' is not provided.
>
> **profile\_type** `string` *required*
>
> The profile type to query. MUST be an exact string from 'profile\_types' output (e.g. 'parca\_agent:samples:count:cpu:nanoseconds:delta'). Do not use shortened names like 'cpu'.

> [accordion] Query profile label values
>
> **Slug:** `POLAR_SIGNALS_MCP_QUERY_PROFILE_LABEL_VALUES`
>
> List the values a profiling label takes (e.g. the process names for the 'comm' label). These are label values used to filter queries — not the sampled values of the profile itself. Use it to discover valid filter values; only use label names from 'query\_profile\_labels'.
>
> #### Input Parameters
>
> **end\_time** `string`
>
> Absolute end time in RFC3339 format (e.g. '2025-01-15T11:00:00Z'). Defaults to now if only 'start\_time' is provided.
>
> **label\_name** `string` *required*
>
> Label name from 'labels' output (e.g. 'service', 'namespace').
>
> **project\_id** `string` *required*
>
> The project ID to query. Get this from the 'list\_projects' tool.
>
> **start\_time** `string`
>
> Absolute start time in RFC3339 format (e.g. '2025-01-15T10:00:00Z'). Takes precedence over 'time\_range'.
>
> **time\_range** `string`
>
> Relative time range for the profile (e.g. '15m', '1h', '24h'). Used when 'start\_time' is not provided.
>
> **profile\_type** `string` *required*
>
> Profile type from 'profile\_types' output (e.g. 'parca\_agent:samples:count:cpu:nanoseconds:delta').

> [accordion] Query profile sandwich
>
> **Slug:** `POLAR_SIGNALS_MCP_QUERY_PROFILE_SANDWICH`
>
> Show the calling context around a specific function: which functions call it (callers) and which functions it calls (callees). Use this after 'query\_profile\_table' to drill into a specific function. The function\_name should be an exact function name from 'query\_profile\_table' results.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> Query in format 'profile\_type' or 'profile\_type\{label="value", ...}'. Use exact profile type from 'profile\_types' (e.g. 'parca\_agent:samples:count:cpu:nanoseconds:delta'), not shortened names. Matchers: = != =\~ !\~. Example: 'parca\_agent:samples:count:cpu:nanoseconds:delta\{service="api"}'.
>
> **end\_time** `string`
>
> Absolute end time in RFC3339 format (e.g. '2025-01-15T11:00:00Z'). Defaults to now if only 'start\_time' is provided.
>
> **project\_id** `string` *required*
>
> The project ID to query. Get this from the 'list\_projects' tool.
>
> **start\_time** `string`
>
> Absolute start time in RFC3339 format (e.g. '2025-01-15T10:00:00Z'). Takes precedence over 'time\_range'.
>
> **time\_range** `string`
>
> Relative time range for the profile (e.g. '15m', '1h', '24h'). Used when 'start\_time' is not provided.
>
> **function\_name** `string` *required*
>
> Exact function name to show sandwich view for (from query\_profile\_table results)

> [accordion] Query profile source
>
> **Slug:** `POLAR_SIGNALS_MCP_QUERY_PROFILE_SOURCE`
>
> Retrieve per-line profiling data for a specific source file. Returns line numbers with flat and cumulative sample counts — without returning the source code itself (read the file directly and correlate using line numbers).
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of lines to return per file, sorted by cumulative descending. Defaults to 100. Use 0 to return all lines.
>
> **query** `string` *required*
>
> Query in format 'profile\_type\{label="value"}'. Same syntax as query\_profile\_table.
>
> **end\_time** `string`
>
> Absolute end time in RFC3339 format (e.g. '2025-01-15T11:00:00Z'). Defaults to now if only 'start\_time' is provided.
>
> **filename** `string` *required*
>
> The source filename (e.g. '/app/main.go').
>
> **project\_id** `string` *required*
>
> The project ID to query. Get this from the 'list\_projects' tool.
>
> **start\_time** `string`
>
> Absolute start time in RFC3339 format (e.g. '2025-01-15T10:00:00Z'). Takes precedence over 'time\_range'.
>
> **time\_range** `string`
>
> Relative time range for the profile (e.g. '15m', '1h', '24h'). Used when 'start\_time' is not provided.

> [accordion] Query profile table
>
> **Slug:** `POLAR_SIGNALS_MCP_QUERY_PROFILE_TABLE`
>
> Query profiling data as a flat table of functions sorted by cumulative time. Recommended workflow: first call 'list\_projects', then 'profile\_types', then 'labels', then 'values' to discover valid query components. Query syntax: 'profile\_type\{label="value"}' where all components come from previous tool outputs. With symbolized=false, unsymbolized rows (no function\_name) gain an 'address' column carrying their hex memory address.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of rows to return, sorted by cumulative descending. Defaults to 100. Use 0 to return all rows.
>
> **query** `string` *required*
>
> Query in format 'profile\_type' or 'profile\_type\{label="value", ...}'. Use exact profile type from 'profile\_types' (e.g. 'parca\_agent:samples:count:cpu:nanoseconds:delta'), not shortened names. Matchers: = != =\~ !\~. Example: 'parca\_agent:samples:count:cpu:nanoseconds:delta\{service="api"}'.
>
> **end\_time** `string`
>
> Absolute end time in RFC3339 format (e.g. '2025-01-15T11:00:00Z'). Defaults to now if only 'start\_time' is provided.
>
> **filename** `string`
>
> Filter results by filename (substring match on the source file path)
>
> **project\_id** `string` *required*
>
> The project ID to query. Get this from the 'list\_projects' tool.
>
> **start\_time** `string`
>
> Absolute start time in RFC3339 format (e.g. '2025-01-15T10:00:00Z'). Takes precedence over 'time\_range'.
>
> **symbolized** `boolean`
>
> If true (default), only show symbolized rows with resolved function names. Set to false to include unsymbolized entries.
>
> **time\_range** `string`
>
> Relative time range for the profile (e.g. '15m', '1h', '24h'). Used when 'start\_time' is not provided.

> [accordion] Query profile types
>
> **Slug:** `POLAR_SIGNALS_MCP_QUERY_PROFILE_TYPES`
>
> ProfileTypes returns the list of available profile types. IMPORTANT: Call 'list\_projects' first to get a project ID. Profile types follow the format 'name:sample\_type:sample\_unit:period\_type:period\_unit\[:delta]' (e.g. 'parca\_agent:samples:count:cpu:nanoseconds:delta'). You MUST use these exact strings when calling 'labels' or 'query\_profile\_table' - do not invent or shorten profile type names.
>
> #### Input Parameters
>
> **end\_time** `string`
>
> Absolute end time in RFC3339 format (e.g. '2025-01-15T11:00:00Z'). Defaults to now if only 'start\_time' is provided.
>
> **project\_id** `string` *required*
>
> The project ID to query. Get this from the 'list\_projects' tool.
>
> **start\_time** `string`
>
> Absolute start time in RFC3339 format (e.g. '2025-01-15T10:00:00Z'). Takes precedence over 'time\_range'.
>
> **time\_range** `string`
>
> Relative time range for the profile (e.g. '15m', '1h', '24h'). Used when 'start\_time' is not provided.
