get_facebook_stories
Retrieve Facebook Stories data from your Metricool brand account by specifying the blog ID and date range. Extract story insights for analysis or reporting purposes.
Instructions
Get the list of Facebook Stories from your Metricool brand account.
Args: init date: Init date of the period to get the data. The format is YYYY-MM-DD end date: End date of the period to get the data. The format is YYYY-MM-DD blog id: Blog id of the Metricool brand account.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blog_id | Yes | ||
| end_date | Yes | ||
| init_date | Yes |
Implementation Reference
- src/mcp_metricool/tools/tools.py:186-204 (handler)The main handler function for the 'get_facebook_stories' tool. It is decorated with @mcp.tool(), which registers it as an MCP tool. The function fetches Facebook stories data from Metricool API using a GET request, with input parameters for date range and blog ID. The docstring provides the schema description.
@mcp.tool() async def get_facebook_stories(init_date: str, end_date: str, blog_id: int) -> str | dict[str, Any]: """ Get the list of Facebook Stories from your Metricool brand account. Args: init date: Init date of the period to get the data. The format is YYYY-MM-DD end date: End date of the period to get the data. The format is YYYY-MM-DD blog id: Blog id of the Metricool brand account. """ url = f"{METRICOOL_BASE_URL}/v2/analytics/stories/facebook?from={init_date}T00%3A00%3A00&to={end_date}T23%3A59%3A59&blogId={blog_id}&userId={METRICOOL_USER_ID}&integrationSource=MCP" response = await make_get_request(url) if not response: return ("Failed to get Facebook Stories") return response