# `TMCP037` search_tests filtered by category

The user shall be able to filter tests by category and receive
only tests belonging to that category.


:::{dropdown} Is a test for
:open: 
:icon: check-circle-fill
:color: primary

[`MCP011` Search and filter tests](/requirements/MCP011)
:::
:::{dropdown} Automated in
:open: 
:icon: check-circle-fill
:color: success

{fab}`python` [`test_search_by_category`](https://github.com/agagniere/speky/blob/master/tests/test_mcp_server.py#L464)
:::
:::{dropdown} Source
:icon: file-code
:color: info

__Source file__: [`specs/mcp/test_11.yaml`](https://github.com/agagniere/speky/blob/master/specs/mcp/test_11.yaml)

__Loaded from__: [`speky_mcp`](https://github.com/agagniere/speky/blob/master/specs/mcp/mcp.toml)

:::

## Initial state
The expected state is the final state of
[`TMCP003` Initialize the MCP server](/tests/TMCP003)
## Procedure
### Step 1
The client calls `search_tests` with category `functional`
```json
{
  "id": 2,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_tests",
    "arguments": {"category": "functional"}
  }
}

```
### Step 2
Verify only functional tests are returned. T03 and T04 (non-functional) must not appear.
```json
{
  "id": 2,
  "jsonrpc": "2.0",
  "result": {
    "structuredContent": {
      "tests": [
        {"category": "functional", "id": "T01"},
        {"category": "functional", "id": "T02", "short": "Second test"}
      ]
    }
  }
}

```