You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(k8s-proxy): update REST API section for in-cluster automation
Refine the documentation for the Kubernetes Proxy REST API, emphasizing that all console
actions are accessible via REST calls. Removed details about the MCP server and its tools,
focusing instead on the available endpoints for recording, testing, and status monitoring.
Signed-off-by: Asish Kumar <officialasishkumar@gmail.com>
Copy file name to clipboardExpand all lines: versioned_docs/version-4.0.0/running-keploy/k8s-proxy-api.md
+2-16Lines changed: 2 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -74,23 +74,9 @@ A naive recorder turns a load test of `GET /users/42` into 50,000 identical test
74
74
75
75
Enable per-recording with `record_config.static_dedup`, and optionally narrow the dedup key per endpoint with `record_config.custom_dedup_fields`, which declares which JSON paths in the request body, plus method/path/status, define "the same test." The agent enforces this _at capture time_ before anything is written to storage, and per-pod dedup stats stream back into the recording status endpoint so you can watch duplicates being dropped live. See [Static Deduplication](/docs/keploy-cloud/static-deduplication/) for the full configuration reference.
76
76
77
-
### 3. REST API _and_ MCP server
77
+
### 3. REST API for in-cluster automation
78
78
79
-
Keploy exposes automation surfaces at two layers:
80
-
81
-
- The **Kubernetes Proxy REST API** ([Endpoint reference](#endpoint-reference)) handles in-cluster operations such as starting/stopping recording, kicking off replay, fetching session status, and reading logs or reports. All routes outside `/healthz` and the admission webhook sit behind shared-token Bearer auth.
82
-
- The **Keploy API server MCP endpoint** exposes higher-level tools for AI coding tools, including Claude Code, Cursor, Windsurf, and VS Code. This is how an AI agent in your editor authors test suites, runs replays, and scaffolds CI pipelines without you copy-pasting curl commands.
83
-
84
-
The MCP surface includes around a dozen tools. The headline ones:
85
-
86
-
-`generate_and_wait`: build a suite from an OpenAPI spec.
87
-
-`run_and_report`: run a suite and return failures + coverage.
88
-
-`get_coverage_gaps`: list which endpoints lack test coverage.
89
-
-`create_test_suite` / `update_test_suite`: programmatically author and validate suites. Writes are gated through Keploy's own branching model (parallel to git), so AI agents can iterate without polluting `main`.
90
-
-`start_rerecord_session` / `start_integration_test_session`: kick off a sandbox session locally.
91
-
-`scaffold_pipeline_workflow`: generate a CI workflow file (covered in benefit 6).
92
-
93
-
A non-obvious detail: when an AI agent authors a test suite that mutates state (POST/PUT/PATCH), the MCP refuses to insert it unless every mutating step's body references at least one per-run dynamic variable, and the rejection error _names_ the dynamic variables already in scope. The result is suites that survive a second run by construction. They are authored and verified to be safe to retry.
79
+
Every action you perform from the Console or `kubectl-keploy` is also available as a REST call. The [endpoint reference](#endpoint-reference) covers the full surface—`/record/start`, `/record/stop`, `/test/start`, `/deployments`, `/proxy/update`, the streaming status endpoints, the log and report endpoints, and the `/k8s-proxy/*` data routes the Console uses for stored test cases, mocks, schema, and reports.
0 commit comments