Skip to main content
GET
Get one mock tool

Authorizations

X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Path Parameters

id
integer
required

A unique integer value identifying this tool.

Response

200 - application/json
name
string
required

Name of the tool - must be less than 64 characters and contain only alphanumerics, underscores, hyphens, and spaces between words (no leading or trailing spaces)

Maximum string length: 255
id
integer
read-only
description
string

Description of the mock tool. Example: "This tool retrieves user data from the database based on user ID"

information
any

Information of the tool - must be a list of input-output mappings. Each mapping may add an optional response ({status_code, headers, delay_seconds}) to simulate a failing or slow tool: status_code 200-299 (except 204 and 205) or 400-599 (default 200), delay_seconds up to 300. headers apply to webhook-style tools only; MCP and VAPI function calls carry the status in the tool result instead.

Mappings may also follow the call's progress: state (the call state(s) a mapping answers in, a name or a list; every call starts in "start") and then (the state the call moves to after the mapping replies). match "exact" requires every input key to be present and equal (default "flexible"). Mappings for the call's current state are served before mappings without a state, and within each, a mapping whose input is identical to the call's arguments comes first. The call is identified by the X-Cekura-Mock-Session header, or by the provider's call id; without one the call stays in "start". Example:

freetext_params
any

Parameter names skipped during mock matching because they are free-text (e.g. ["notes", "reason"])

mock_url
string
read-only

Per-tool webhook URL. None if this Tool is served through an MCP endpoint.

served_via
string
read-only

How this tool is accessed at runtime. {'type': 'direct'} for standalone tools; {'type': 'mcp', 'mock_index': N, 'url': '.../mcp/N/', 'server_name': ...} for MCP sub-tools.

mcp_server
string
read-only

MCP server this tool was fetched from, as {'name', 'key'}. Null for standalone (non-MCP) tools. Server-managed — ignored on writes.

subscriber_count
string
read-only

Number of agents in the project sharing this tool.

is_shared
boolean
read-only

True when more than one agent shares this tool. Edits and deletes affect every subscriber.

subscribers
object[]
read-only

Agents using this tool, so a caller can see who an edit would affect.