goodday-mcp

Instructions

Implementation Reference

• goodday_mcp/main.py:633-649 (handler)

  The handler function for the 'get_user' MCP tool. It fetches user details from the Goodday API endpoint 'user/{user_id}' and formats the response using format_user.
  @mcp.tool() async def get_user(user_id: str) -> str: """Get details of a specific user. Args: user_id: The ID of the user to retrieve """ data = await make_goodday_request(f"user/{user_id}") if not data: return "User not found." if isinstance(data, dict) and "error" in data: return f"Unable to fetch user: {data.get('error', 'Unknown error')}" return format_user(data)
• goodday_mcp/main.py:135-149 (helper)

  Helper function used by get_user to format the raw user data dictionary into a human-readable string.
  def format_user(user: dict) -> str: """Format a user into a readable string with safe checks.""" if not isinstance(user, dict): return f"Invalid user data: {repr(user)}" # Defensive defaults in case nested keys are not dicts role = user.get('role') if isinstance(user.get('role'), dict) else {} return f""" User ID: {user.get('id', 'N/A')} Name: {user.get('name', 'N/A')} Email: {user.get('email', 'N/A')} Role: {role.get('name', 'N/A')} Status: {user.get('status', 'N/A')} """.strip()
• goodday_mcp/main.py:165-173 (helper)

  Helper function to fetch all users and create a mapping of user IDs to names, potentially useful for resolving user names in tool outputs.
  async def get_user_mapping() -> dict: """Get mapping of user IDs to names.""" data = await make_goodday_request("users") user_id_to_name = {} if isinstance(data, list): for u in data: if isinstance(u, dict): user_id_to_name[u.get("id")] = u.get("name", "Unknown") return user_id_to_name
• goodday_mcp/main.py:633-633 (registration)

  MCP tool registration decorator for the get_user function.
  @mcp.tool()