ci(mcp): name the MCP gate per SDK major — MCP SDK v1/v2 (Python X.Y)

Reshape tests-mcp-v2 into a tests-mcp matrix over {v1, v2} x {3.10, 3.14},
so the checks list shows an explicit per-major signal instead of the v1
side being buried inside the whole-repo tests matrix. The v1 leg uses the
lockfile's mcp 1.x as-is; the v2 leg swaps in mcp>=2,<3 and drops jlowin
fastmcp (pins mcp<2). The main tests matrix is unchanged.

Generated-By: PostHog Code
Task-Id: ebafcb71-b03b-443d-b40c-d527ed4a04f4

Author: gesh

.github/workflows/ci.yml

@@ -151,16 +151,18 @@ jobs:
               run: |
                   pytest --verbose --timeout=30
 
-    tests-mcp-v2:
-        # The MCP suite again, against MCP Python SDK v2 (spec 2026-07-28). The
-        # `tests` matrix covers mcp 1.x on every Python version; this lane swaps
-        # in mcp>=2 (and drops jlowin fastmcp, which pins mcp<2) and runs only
-        # posthog/test/mcp — conftest.py there splits collection by major.
-        name: MCP SDK v2 tests (Python ${{ matrix.python-version }})
+    tests-mcp:
+        # The MCP suite as a named gate per MCP Python SDK major. The v1 leg uses
+        # the lockfile's mcp 1.x (also exercised incidentally by the `tests`
+        # matrix — this leg exists as an explicit, named signal); the v2 leg
+        # (spec 2026-07-28) swaps in mcp>=2 and drops jlowin fastmcp, which pins
+        # mcp<2. posthog/test/mcp/conftest.py splits collection by major.
+        name: MCP SDK ${{ matrix.mcp-major }} (Python ${{ matrix.python-version }})
         runs-on: ubuntu-latest
         strategy:
             matrix:
                 python-version: ['3.10', '3.14']
+                mcp-major: ['v1', 'v2']
 
         steps:
             - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
@@ -178,14 +180,19 @@ jobs:
                   version: "0.11.32"
                   enable-cache: true
 
-            - name: Install test dependencies with MCP SDK v2
+            - name: Install test dependencies
               shell: bash
               run: |
                   UV_PROJECT_ENVIRONMENT=$pythonLocation uv sync --extra test
+
+            - name: Swap in MCP SDK v2
+              if: matrix.mcp-major == 'v2'
+              shell: bash
+              run: |
                   uv pip uninstall --python $pythonLocation fastmcp
                   uv pip install --python $pythonLocation 'mcp>=2,<3'
 
-            - name: Run MCP tests against SDK v2
+            - name: Run MCP tests against SDK ${{ matrix.mcp-major }}
               run: |
                   pytest posthog/test/mcp --verbose --timeout=30
 

posthog/test/mcp/conftest.py

@@ -1,7 +1,8 @@
 """Split the MCP test suite by installed MCP SDK major.
 
-The suite runs twice in CI: once against ``mcp>=1.26,<2`` (the ``tests`` job)
-and once against ``mcp>=2,<3`` (the ``tests-mcp-v2`` job). Files coupled to one
+The suite runs against both majors in CI — the ``tests-mcp`` matrix has a
+``mcp>=1.26,<2`` leg and a ``mcp>=2,<3`` leg (the main ``tests`` matrix also
+exercises the v1 side incidentally). Files coupled to one
 major's seams import symbols the other major doesn't ship, so they are excluded
 from *collection* (a skip marker can't help — the failure is at import time).
 Version-agnostic files (units, truncation, session tokens, PostHogMCP, ids)