MMetadata /docs
⌘K
Docs/Tools/search_ma_lists

search_ma_lists

Search the connected marketing automation (MA) tool's destination lists by name.

Read other

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Search the connected marketing automation (MA) tool's destination lists by name.

                    USAGE INSTRUCTIONS FOR LLM:
                    Use this to find a concrete marketing-automation list before setting it as the
                    account's default destination list. This tool is the ONLY safe way to resolve a
                    list id: never invent, guess, or reuse a list id from memory or from a different
                    account. Always call this first, confirm the match with the user if there are
                    several, and pass the exact "listId" from the result to set_default_ma_list.

                    WHEN TO USE THIS TOOL:
                    - User wants to set or change the default marketing automation destination list
                    - User asks "which MA lists do we have?" or "find the list named X"
                    - Before calling set_default_ma_list

                    RESPONSE FORMAT:
                    Returns {"lists": [{"listId": int, "name": str}, ...]}. An empty array means no
                    marketing automation tool is connected, or nothing matched the search text.

                    EXAMPLE: "Set the default MA list to Newsletter Signups" -> search_ma_lists(name="Newsletter Signups")
                    then set_default_ma_list(list_id=<matched listId>)

Arguments

ArgumentTypeNotes
name string required Free-text search string to filter destination lists by name.

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.

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_ma_lists","arguments":{"name":"<name>"}}}'

Response

No recorded response. This tool needs arguments that only exist inside an account, so no response is recorded here. The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other other tools:

Browse the tool catalog · machine-readable index