MMetadata /docs
Docs/Tools/get_intent_topics

get_intent_topics

Get available intent topics for BOMBOORA audience creation.

Read audiences

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

What it does

Get available intent topics for BOMBOORA audience creation.

                        IMPORTANT:
                        Call this tool first before suggesting or creating any Bombora audience.
                        If the response returns NO topics (empty list), Bombora is NOT available for this account —
                        do NOT suggest Bombora audiences. Instead, recommend creating a firmographic audience
                        (create_firmographic_audience) as the preferred alternative.

                        Retrieves the list of available buyer intent topics that can be used
                        when creating BOMBOORA intent topic audiences. These intent topics represent different
                        buyer interest areas and purchasing signals that can be used for precise audience targeting.

                        WHEN TO USE:
                        - Always call this BEFORE suggesting or creating a Bombora audience to verify topic availability
                        - Discover available intent topics before creating a BOMBOORA intent topic audience
                        - Understand what buyer intent signals are available for targeting
                        - Build audiences based on specific buyer interests and purchasing signals
                        - Integrate intent topic selection into the audience creation flow

                        RETURNS:
                        List of available intent topics with their details including:
                        - Topic ID/name
                        - Topic description
                        - Available packages or categories
                        - Any additional metadata for targeting configuration

                        NEXT STEPS:
                        After retrieving intent topics, use the intent topic IDs with the audience
                        creation tool to create BOMBOORA intent topic based audiences.

Arguments

Takes no arguments.

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

Response

Real, from the production server, in 245 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
[
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]",
 "[value redacted]"
]

Other audiences tools:

All 160 tools · machine-readable index