get_pinterest_boards
Retrieve Pinterest boards associated with a specific Metricool brand account using the provided blog_id. Ensures accurate board management and tracking by identifying the correct account.
Instructions
Get the list of Pinterest boards for a specific Metricool brand (blog_id). If the user doesn't provide a blog_id, ask for it.
Args: blog_id: Blog id of the Metricool brand account.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blog_id | Yes |
Implementation Reference
- src/mcp_metricool/tools/tools.py:460-476 (handler)Handler function for the 'get_pinterest_boards' tool. It is registered via the @mcp.tool() decorator on FastMCP instance. Makes a GET request to Metricool API to retrieve Pinterest boards for the given blog_id.
@mcp.tool() async def get_pinterest_boards(blog_id: int) -> str | dict[str, Any]: """ Get the list of Pinterest boards for a specific Metricool brand (blog_id). If the user doesn't provide a blog_id, ask for it. Args: blog_id: Blog id of the Metricool brand account. """ url = f"{METRICOOL_BASE_URL}/v2/scheduler/boards/pinterest?blogId={blog_id}&userId={METRICOOL_USER_ID}&integrationSource=MCP" response = await make_get_request(url) if not response: return "Failed to get pinterest boards" return response - src/mcp_metricool/tools/tools.py:460-460 (registration)The @mcp.tool() decorator registers the get_pinterest_boards function as a tool in the FastMCP server (initialized at line 17).
@mcp.tool() - Docstring provides input schema: requires blog_id (int). Output is str or dict[str, Any].
""" Get the list of Pinterest boards for a specific Metricool brand (blog_id). If the user doesn't provide a blog_id, ask for it. Args: blog_id: Blog id of the Metricool brand account. """