Keploy

Start the Path B agent-walked install for the V1 flow. Returns a playbook the AI walks with the dev to land a kep_* PAT in their editor's MCP config. Current implementation routes through app.keploy.io/settings/api-keys (the existing PAT-issuance surface). The full auto-provision OAuth round-trip (browser OAuth → /auth/temp-code/exchange → /user/mcp/provision → PAT auto-pasted) lands when the enterprise-ui /auth/cli-install page is built; this tool's interface won't change when that lifts, only the underlying steps will get shorter. ABSOLUTE: this tool surfaces a public URL. Do NOT print API keys, PATs, or OAuth tokens to the conversation. The dev pastes the secret into their editor config directly; the agent never sees it.

{
  "type": "object",
  "properties": {
    "editor": {
      "description": "Editor the dev is using (cursor / windsurf / claude-code / claude-desktop / vscode / trae). Tailors the config-path hint in the playbook. Omit if unknown.",
      "type": "string"
    }
  },
  "required": []
}

Return the V1 "user maintains the flow" install guide — covers Path A (clipboard one-liner), Path B (agent-walked OAuth), and the keploy/api-tests/ on-disk layout V1 creates. Safe to call without authentication; call this when the dev asks 'how do I add Keploy to this repo?' or when a devloop_* tool returns missing-API-key.

{
  "type": "object",
  "properties": {},
  "required": []
}

Check whether the current MCP session has a valid-looking Keploy PAT attached. Returns { authenticated, auth_header_present, hint }. Useful as a first step for an agent to decide whether to call other tools or show setup instructions — differentiates 'no header at all' from 'header present but wrong prefix / unsupported format'.

{
  "type": "object",
  "properties": {},
  "required": []
}

Return step-by-step instructions for connecting this MCP server to Cursor, Windsurf, VS Code, Claude Desktop, Claude Code, or Trae. Safe to call without authentication — use this when the user asks 'how do I set up Keploy MCP?' or when a tool call fails with an auth error.

{
  "type": "object",
  "properties": {},
  "required": []
}

Fetch the exact schema(s) for tool(s) you ALREADY know by name — e.g. names a skill/playbook gave you (getTestReportFull, updateTestCase, listTestReports, getMock, getTestCase, getApp, listApps, ...). Returns ONLY the named tools: no fuzzy matching, no unrelated tools. Use this instead of search_tools whenever you know the name — it is exact and cheap. Use search_tools only to DISCOVER names you do not already know. Returns {"tools": [{name, description, inputSchema}, ...], "not_found": [names...]}.

{
  "type": "object",
  "properties": {
    "names": {
      "description": "Exact tool names, e.g. [\"getTestReportFull\",\"updateTestCase\"].",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "names"
  ]
}

Run any Keploy tool by name. Most tools are hidden from the default list. Know the name from a skill? get its schema with get_tool_schema; don't know the name? discover it with search_tools. Then call invoke_tool with that name and an "arguments" object matching the tool's inputSchema. Example: invoke_tool {"name": "getTestReportFull", "arguments": {"appId": "...", "testRunId": "...", "fields": ["status"]}}

{
  "type": "object",
  "properties": {
    "arguments": {
      "description": "Arguments object matching the target tool's inputSchema. Omit or pass {} for tools that take no args.",
      "properties": {},
      "type": "object"
    },
    "name": {
      "description": "Exact tool name from search_tools, e.g. 'getTestReportFull'.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ]
}

DISCOVER tool names you do NOT already know, by keyword. Most Keploy tools are hidden from the default tool list to save context. If you ALREADY know the exact name (e.g. a skill named it), call get_tool_schema instead — it is exact and far cheaper than this fuzzy search. Returns {"matches": [{name, description, inputSchema}, ...], "total_catalog": N}. Search by intent words, e.g. "test report", "mock patch", "update test case", "cloud replay branch", "record".

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max results (default 10).",
      "type": "number"
    },
    "query": {
      "description": "Keywords matched against tool name + description, e.g. 'test report fields' or 'mock patch'.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}