---
title: "search_experiments. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/search_experiments
description: "Search for experiments by name, status, and budget group with flexible filtering. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response."
source: metadata.io
---

# search_experiments

Search for experiments by name, status, and budget group with flexible filtering.

Read [campaigns](https://metadata.io/developers/tools/#cat-campaigns)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `search_name` | string |   | The experiment or campaign name to search for (partial, case-insensitive matching). Optional - omit to skip name filtering. |
| `budget_group_ids` | array |   | Optional array of budget group IDs to filter experiments. Only returns experiments that belong to these budget groups. |
| `launched_experiment_statuses` | array |   | Optional array of experiment statuses to filter by. Valid values: Active, WithoutSpend, Paused, Completed, Failed, Disconnected |
| `page` | integer |   | Page number for pagination (default: 0) |
| `size` | integer |   | Number of results per page (default: 5) |
| `sort` | string |   | Sort criteria in format 'field,direction' (e.g., 'name,asc') |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

Real, from the production server, in **8179 ms**. The full response was 17,256 bytes; this is the first part of it. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

## Related

Other campaigns tools:

- [add_and_edit_campaign_elements](https://metadata.io/developers/tools/add_and_edit_campaign_elements) Destructive
- [add_and_edit_native_campaign_elements](https://metadata.io/developers/tools/add_and_edit_native_campaign_elements) Destructive
- [check_campaign_launch_readiness](https://metadata.io/developers/tools/check_campaign_launch_readiness) Read
- [connect_channel](https://metadata.io/developers/tools/connect_channel) Writes
- [create_budget_group](https://metadata.io/developers/tools/create_budget_group) Writes
- [create_campaign](https://metadata.io/developers/tools/create_campaign) Writes
- [create_native_structure_campaign](https://metadata.io/developers/tools/create_native_structure_campaign) Writes
- [create_update_offer](https://metadata.io/developers/tools/create_update_offer) Destructive

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)