search_campaigns_by_names
Search for campaigns by name to get campaign details, IDs, and status.
Read campaigns
Returns data. Calling it changes nothing, so it is safe in an unattended loop.
What it does
Search for campaigns by name to get campaign details, IDs, and status.
KEYWORDS: campaign, search, find, lookup, status, active, paused, draft, marketing, advertising
**USE THIS TOOL WHEN THE USER ASKS ABOUT:**
- Campaign details, information, or status
- Finding a campaign by name
- Getting campaign IDs
- Checking if a campaign exists
- Looking up campaign status (active, paused, draft)
- Any question containing words like: "campaign", "show me", "find", "search", "list", "details", "status"
**ALWAYS use this tool first** before launching, updating, or referencing any campaign.
SEARCH FEATURES:
- Partial, case-insensitive matching (e.g., "Q1" matches "Q1_2026_Campaign")
- Returns campaign ID, full name, and current status
- Searches up to 150 visible campaigns per term
PARAMETERS:
- campaign_names: Array of campaign name strings to search for (required)
RETURNS:
{
"found_campaigns": [
{
"id": 159490,
"name": "LinkedIn_BoFu_Q1_2026",
"statusLabel": "Active"
}
],
"missing_names": ["NonExistent"],
"total_found": 1
}
STATUS LABELS: Active, Paused, Draft, Completed, Unknown
Use returned campaign IDs with launch_campaign or manage_campaign tools.
Anchor all date-related decisions to the REAL current date — call get_current_date if you are not already certain what today is.Arguments
| Argument | Type | Notes | |
|---|---|---|---|
campaign_names |
array | required | Array of campaign names or partial names to search for (case-insensitive, partial matching) |
Request
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_campaigns_by_names","arguments":{"campaign_names":[]}}}'
Response
No recorded response. This tool needs arguments that only exist inside an account, so no response is recorded here.
The request above is still the exact shape to send. Nothing on this page is invented.
Related
Other campaigns tools: