From b4a544dbea6e5ebdd2c6924958bd1c3e8cc70139 Mon Sep 17 00:00:00 2001
From: Kenneth Johnson <kjohnson@cloudflare.com>
Date: Wed, 14 Oct 2026 16:44:53 -0500
Subject: [PATCH 1/2] [Access] Document MCP analytics response-status filtering

---
 ...26-10-14-mcp-analytics-response-status.mdx | 20 +++++++++++++++++++
 .../ai-controls/mcp-portals.mdx               | 17 +++++++++-------
 2 files changed, 30 insertions(+), 7 deletions(-)
 create mode 100644 src/content/changelog/access/2026-10-14-mcp-analytics-response-status.mdx

diff --git a/src/content/changelog/access/2026-10-14-mcp-analytics-response-status.mdx b/src/content/changelog/access/2026-10-14-mcp-analytics-response-status.mdx
new file mode 100644
index 00000000000..8715fd6d912
--- /dev/null
+++ b/src/content/changelog/access/2026-10-14-mcp-analytics-response-status.mdx
@@ -0,0 +1,20 @@
+---
+title: Filter MCP tool-call analytics by response status
+description: Count successful, failed, or cached MCP tool calls separately, with successful calls as the default.
+date: 2026-10-14
+products:
+  - access
+  - cloudflare-one
+---
+
+MCP tool-call analytics support a `response_status` query parameter on the account, portal, and server timeseries endpoints. Use `success`, `error`, or `cached` to count one status, or `all` to include every status.
+
+The default is `success`. Previously, counts included failed and cached calls. If you need the previous all-status counts, set `response_status=all` explicitly:
+
+```txt
+GET /accounts/{account_id}/access/ai-controls/mcp/analytics/tool-calls/timeseries?response_status=all
+```
+
+The response includes the selected `response_status`. Invalid values, including an empty value, return `400`.
+
+For all query parameters and scoped endpoints, refer to [View tool-call analytics](/cloudflare-one/access-controls/ai-controls/mcp-portals/#view-tool-call-analytics).
diff --git a/src/content/docs/cloudflare-one/access-controls/ai-controls/mcp-portals.mdx b/src/content/docs/cloudflare-one/access-controls/ai-controls/mcp-portals.mdx
index c7a31474b45..134c8158bd6 100644
--- a/src/content/docs/cloudflare-one/access-controls/ai-controls/mcp-portals.mdx
+++ b/src/content/docs/cloudflare-one/access-controls/ai-controls/mcp-portals.mdx
@@ -700,6 +700,8 @@ The `auth_credentials` field accepts two forms:
 
 Use the account endpoint to retrieve daily or monthly MCP tool-call counts across the account:
 
+By default, these counts include only successful tool calls. To include errors and cached calls, set `response_status=all`. Use `error` or `cached` to count either status separately.
+
 <CURL
 	url="https://api.cloudflare.com/client/v4/accounts/{account_id}/access/ai-controls/mcp/analytics/tool-calls/timeseries?granularity=daily&aggregate=false&tz=utc&days=30"
 	method="GET"
@@ -708,14 +710,15 @@ Use the account endpoint to retrieve daily or monthly MCP tool-call counts acros
 
 The same query parameters apply to each endpoint:
 
-| Parameter     | Values and behavior                                                                                                                                                         |
-| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `granularity` | `daily` or `monthly`. Defaults to `daily`.                                                                                                                                   |
-| `aggregate`   | `true` or `false`. Defaults to `false`. Set to `true` to request aggregated counts.                                                                                          |
-| `tz`          | `utc`, `Z`, or a fixed `+HH:MM` or `-HH:MM` offset. Defaults to `utc`. Offsets range from `-12:00` through `+14:00`; `+14:00` and `-12:00` are the limits. The offset is used for local-day bucketing and does not account for daylight saving time changes within the window. |
-| `days`        | An integer from `1` to `179`. For daily results, this sets the trailing window and defaults to `7`. It is ignored when `granularity=monthly`.                               |
+| Parameter         | Values and behavior                                                                                                                                                                                                                                                            |
+| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `granularity`     | `daily` or `monthly`. Defaults to `daily`.                                                                                                                                                                                                                                     |
+| `aggregate`       | `true` or `false`. Defaults to `false`. Set to `true` to request aggregated counts.                                                                                                                                                                                            |
+| `tz`              | `utc`, `Z`, or a fixed `+HH:MM` or `-HH:MM` offset. Defaults to `utc`. Offsets range from `-12:00` through `+14:00`; `+14:00` and `-12:00` are the limits. The offset is used for local-day bucketing and does not account for daylight saving time changes within the window. |
+| `days`            | An integer from `1` to `179`. For daily results, this sets the trailing window and defaults to `7`. It is ignored when `granularity=monthly`.                                                                                                                                  |
+| `response_status` | `success`, `error`, `cached`, or `all`. Defaults to `success`. Set to `all` to include every status. Invalid values, including an empty value, return `400`.                                                                                                                   |
 
-The response `result` includes the selected `granularity`, `aggregate`, and `tz`, the `start` and `end` of the window as epoch milliseconds, a `series` of `day` and `count` values, and the `total` count. The window includes `start` and excludes `end`. Daily `day` values use `YYYY-MM-DD` in the requested timezone offset.
+The response `result` includes the selected `granularity`, `aggregate`, `tz`, and `response_status`, the `start` and `end` of the window as epoch milliseconds, a `series` of `day` and `count` values, and the `total` count. The window includes `start` and excludes `end`. Daily `day` values use `YYYY-MM-DD` in the requested timezone offset.
 
 Use a scoped endpoint to limit the counts:
 

From b318d1eddca0c65f99b57c7d296d90c9ff39be18 Mon Sep 17 00:00:00 2001
From: vance <root.mvm@gmail.com>
Date: Fri, 16 Oct 2026 16:48:23 -0500
Subject: [PATCH 2/2] Empty commit to trigger worker preview