mcp-metricool

Instructions

Implementation Reference

• src/mcp_metricool/tools/tools.py:246-264 (handler)

  Handler function decorated with @mcp.tool() that implements the get_bluesky_posts tool. It fetches Bluesky posts from the Metricool API for a given date range and blog ID, using make_get_request utility. The function signature and docstring define the input schema and description.

  @mcp.tool()
  async def get_bluesky_posts(init_date: str, end_date: str, blog_id: int) -> str | dict[str, Any]:
      """
      Get the list of Bluesky Posts 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/posts/bluesky?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 Bluesky Posts")
  
      return response

• src/mcp_metricool/utils/utils.py:134-146 (helper)

  Utility function used by the handler to make authenticated GET requests to the Metricool API.

  async def make_get_request(url: str) -> dict[str, Any] | None:
      """Make a get request to the Metricool API with proper error handling."""
      headers = {
          "X-Mc-Auth": METRICOOL_USER_TOKEN,
      }
      async with httpx.AsyncClient() as client:
          try:
              response = await client.get(url, headers=headers, timeout=30.0)
              response.raise_for_status()
              return response.json()
          except Exception:
              return None

• src/mcp_metricool/server.py:1-7 (registration)

  Server file that imports the mcp instance from tools (where tools are registered via @mcp.tool() decorators) and runs the MCP server.

  from .tools import tools
  
  mcp = tools.mcp
  
  if __name__ == "__main__":
      # Initialize and run the server
      mcp.run(transport='stdio')