GrowthLoop MCP Tools

GrowthLoop MCP tools are generated from supported GrowthLoop Public API endpoints. Tool names describe the action they perform, such as listing audiences, creating an audience, or invoking Marve.

How to Choose a Tool

Use direct GrowthLoop tools for specific actions:

  • "List my audiences"
  • "Show audience 123"
  • "Create an audience from this json_query"
  • "List exports for this audience"

Use Marve for agentic questions:

  • "What data is available in this dataset group?"
  • "Suggest high-value customer audiences for retention"
  • "Help me refine this audience idea"
  • "Explain which fields I should use to build a win-back segment"

Marve Responses

Marve is a multi-step agent so responses may include multiple messages. A response can include:

  • The user message.
  • Agent activity and status updates.
  • Tool traces, such as SQL Marve, are used to inspect warehouse metadata.
  • A final agent message.
  • Structured outputs, such as audience suggestions, when available.

MCP clients should treat Marve responses as a conversation transcript, not as a single JSON field.

Creating Audiences from Marve Suggestions

When Marve returns audience suggestions, each suggestion can include all the info. Use the Create Audience tool when you are ready to save one of those suggestions as an audience.

Follow-Up Questions

Some MCP clients support a session ID. GrowthLoop can use that session as the Marve chat_id for follow-up questions. If your client does not provide a session ID, GrowthLoop creates a new chat ID for the request.


To continue a specific Marve conversation, pass the returned chat_id When your client supports tool arguments.


Did this page help you?