---
title: "List the mock tools in a project"
method: GET
path: "/test_framework/v1/tools/"
tags: ["test_framework"]
---

# List the mock tools in a project

`GET /test_framework/v1/tools/`

## Request

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

Return the project's mock tools with their input/output pairs and the agents using each one. Scope with `project_id` for the whole catalogue, or with `agent_id` to get only the tools that agent could newly adopt (its own are excluded). `search` matches the tool name, with or without the `c_` prefix. Results are paginated, most-shared first.

## Query parameters

- `page` integer
- `page_size` integer
- `search` string
- `project_id` integer
- `agent_id` integer

## Response `200`

- PaginatedToolList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Tool[], required
    - `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/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)