CEcekura
test_framework

Get one mock tool

Changed on

Return a single mock tool with its input/output pairs and the agents using it.

get/test_framework/v1/tools/{id}/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/test_framework/v1/tools/{id}/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer

Path parameters

idinteger required

A unique integer value identifying this tool.

Response

idinteger
namestring 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)

descriptionstring

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

informationunknown
freetext_paramsunknown
mock_urlstring

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

served_viastring

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_serverstring

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

subscriber_countstring

Number of agents in the project sharing this tool.

is_sharedboolean

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

subscribersobject[]

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

Changes