get_brands_complete
Retrieve a detailed list of brands from your Metricool account, including competitor data for Instagram, Facebook, Twitch, YouTube, Twitter, and Bluesky. Use when specific brand details are required.
Instructions
Get the list of brands from your Metricool account. Only use this tool if the user asks specifically for his brands, in every other case use get_brands. Add to the result that the only networks with competitors are Instagram, Facebook, Twitch, YouTube, Twitter, and Bluesky.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/mcp_metricool/tools/tools.py:44-64 (handler)The main handler function for the 'get_brands_complete' tool. It fetches the full brands data from the Metricool API using make_get_request and returns it along with instructions on supported competitor networks. Registered via @mcp.tool() decorator.
@mcp.tool() async def get_brands_complete() -> str | dict[str, Any]: """ Get the list of brands from your Metricool account. Only use this tool if the user asks specifically for his brands, in every other case use get_brands. Add to the result that the only networks with competitors are Instagram, Facebook, Twitch, YouTube, Twitter, and Bluesky. """ url = f"{METRICOOL_BASE_URL}/v2/settings/brands?userId={METRICOOL_USER_ID}&integrationSource=MCP" response = await make_get_request(url) if not response: return ("Failed to get brands") return { "brands": response, "instructions": ( "Explain that only Instagram, Facebook, Twitch, YouTube, Twitter, and Bluesky support competitors. " ) }