---
title: "Get one mock tool"
method: GET
path: "/test_framework/v1/tools/{id}/"
tags: ["test_framework"]
---

# Get one mock tool

`GET /test_framework/v1/tools/{id}/`

## Request

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

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

## Path parameters

- `id` integer, required

## Response `200`

- Tool
  - `id` integer
  - `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)
  - `description` string: Description of the mock tool. Example: "This tool retrieves user data from the database based on user ID"
  - `information` unknown
  - `freetext_params` unknown
  - `mock_url` string: Per-tool webhook URL. None if this Tool is served through an MCP endpoint.
  - `served_via` string: 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: MCP server this tool was fetched from, as `{'name', 'key'}`. Null for standalone (non-MCP) tools. Server-managed — ignored on writes.
  - `subscriber_count` string: Number of agents in the project sharing this tool.
  - `is_shared` boolean: True when more than one agent shares this tool. Edits and deletes affect every subscriber.
  - `subscribers` object[]: Agents using this tool, so a caller can see who an edit would affect.

## Changes

- **2026-11-03** `a6fb6a739212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/test_framework/v1/tools/:id/get.md)

---

[API](https://skmtc.dev/cekura/apis/cekura-api.md) - [All operations](https://skmtc.dev/cekura/apis/cekura-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cekura/apis/cekura-api/revisions/a6fb6a739212?raw)